@jbctechsolutions/mcp-office365 2.5.1

package/dist/graph/client/graph-client.js

@@ -0,0 +1,1771 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Microsoft Graph API client wrapper.
+ *
+ * Provides a typed interface to the Graph API with:
+ * - Automatic token management
+ * - Response caching
+ * - Pagination support
+ * - Error handling
+ */
+import 'isomorphic-fetch';
+import { Client } from '@microsoft/microsoft-graph-client';
+import { getAccessToken } from '../auth/index.js';
+import { buildBatchPayload, splitIntoBatches, parseBatchResponse } from './batch.js';
+import { ResponseCache, CacheTTL, createCacheKey } from './cache.js';
+/**
+ * Graph client wrapper with caching and token management.
+ */
+export class GraphClient {
+    client = null;
+    cache = new ResponseCache();
+    deviceCodeCallback;
+    constructor(deviceCodeCallback) {
+        this.deviceCodeCallback = deviceCodeCallback;
+    }
+    /**
+     * Gets or creates the Graph client instance.
+     */
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getClient() {
+        if (this.client == null) {
+            this.client = Client.init({
+                // eslint-disable-next-line @typescript-eslint/no-misused-promises
+                authProvider: async (done) => {
+                    try {
+                        const token = await getAccessToken(this.deviceCodeCallback);
+                        done(null, token);
+                    }
+                    catch (error) {
+                        done(error, null);
+                    }
+                },
+            });
+        }
+        return this.client;
+    }
+    /**
+     * Clears the response cache.
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    // ===========================================================================
+    // Mail Folders
+    // ===========================================================================
+    /**
+     * Lists all mail folders.
+     */
+    async listMailFolders() {
+        const cacheKey = createCacheKey('listMailFolders');
+        const cached = this.cache.get(cacheKey);
+        if (cached != null) {
+            return cached;
+        }
+        const client = await this.getClient();
+        const result = [];
+        // Get top-level folders with pagination
+        let response = await client
+            .api('/me/mailFolders')
+            .select('id,displayName,parentFolderId,totalItemCount,unreadItemCount')
+            .top(100)
+            .get();
+        result.push(...response.value);
+        // Handle pagination
+        while (response['@odata.nextLink'] != null) {
+            response = await client.api(response['@odata.nextLink']).get();
+            result.push(...response.value);
+        }
+        // Also get child folders (one level deep)
+        for (const folder of [...result]) {
+            try {
+                const children = await client
+                    .api(`/me/mailFolders/${folder.id}/childFolders`)
+                    .select('id,displayName,parentFolderId,totalItemCount,unreadItemCount')
+                    .get();
+                result.push(...children.value);
+            }
+            catch {
+                // Some folders may not have children or may not be accessible
+            }
+        }
+        this.cache.set(cacheKey, result, CacheTTL.FOLDERS);
+        return result;
+    }
+    /**
+     * Gets a specific mail folder by ID.
+     */
+    async getMailFolder(folderId) {
+        const client = await this.getClient();
+        try {
+            return await client
+                .api(`/me/mailFolders/${folderId}`)
+                .select('id,displayName,parentFolderId,totalItemCount,unreadItemCount')
+                .get();
+        }
+        catch {
+            return null;
+        }
+    }
+    // ===========================================================================
+    // Messages (Emails)
+    // ===========================================================================
+    /**
+     * Lists messages in a folder with pagination.
+     */
+    async listMessages(folderId, limit = 50, skip = 0) {
+        const cacheKey = createCacheKey('listMessages', folderId, limit, skip);
+        const cached = this.cache.get(cacheKey);
+        if (cached != null) {
+            return cached;
+        }
+        const client = await this.getClient();
+        const response = await client
+            .api(`/me/mailFolders/${folderId}/messages`)
+            .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,sentDateTime,isRead,hasAttachments,importance,flag,bodyPreview,conversationId,internetMessageId')
+            .orderby('receivedDateTime desc')
+            .top(limit)
+            .skip(skip)
+            .get();
+        const result = response.value;
+        this.cache.set(cacheKey, result, CacheTTL.EMAILS);
+        return result;
+    }
+    /**
+     * Lists unread messages in a folder.
+     */
+    async listUnreadMessages(folderId, limit = 50, skip = 0) {
+        const client = await this.getClient();
+        const response = await client
+            .api(`/me/mailFolders/${folderId}/messages`)
+            .filter('isRead eq false')
+            .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,sentDateTime,isRead,hasAttachments,importance,flag,bodyPreview,conversationId,internetMessageId')
+            .orderby('receivedDateTime desc')
+            .top(limit)
+            .skip(skip)
+            .get();
+        return response.value;
+    }
+    /**
+     * Searches messages across all folders.
+     */
+    async searchMessages(query, limit = 50) {
+        const client = await this.getClient();
+        const response = await client
+            .api('/me/messages')
+            .search(`"${query}"`)
+            .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,sentDateTime,isRead,hasAttachments,importance,flag,bodyPreview,conversationId,internetMessageId,parentFolderId')
+            .top(limit)
+            .get();
+        return response.value;
+    }
+    /**
+     * Searches messages in a specific folder.
+     */
+    async searchMessagesInFolder(folderId, query, limit = 50) {
+        const client = await this.getClient();
+        const response = await client
+            .api(`/me/mailFolders/${folderId}/messages`)
+            .search(`"${query}"`)
+            .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,sentDateTime,isRead,hasAttachments,importance,flag,bodyPreview,conversationId,internetMessageId')
+            .top(limit)
+            .get();
+        return response.value;
+    }
+    /**
+     * Searches messages using raw KQL (Keyword Query Language).
+     * Unlike searchMessages, the query is passed directly without quote-wrapping,
+     * enabling KQL operators like from:, subject:, hasAttachments:, received>=, AND, OR.
+     */
+    async searchMessagesKql(query, limit = 50) {
+        const client = await this.getClient();
+        const response = await client
+            .api('/me/messages')
+            .search(query)
+            .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,sentDateTime,isRead,hasAttachments,importance,flag,bodyPreview,conversationId,internetMessageId,parentFolderId')
+            .top(limit)
+            .get();
+        return response.value;
+    }
+    /**
+     * Searches messages in a specific folder using raw KQL.
+     */
+    async searchMessagesKqlInFolder(folderId, query, limit = 50) {
+        const client = await this.getClient();
+        const response = await client
+            .api(`/me/mailFolders/${folderId}/messages`)
+            .search(query)
+            .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,sentDateTime,isRead,hasAttachments,importance,flag,bodyPreview,conversationId,internetMessageId,parentFolderId')
+            .top(limit)
+            .get();
+        return response.value;
+    }
+    /**
+     * Lists messages in a conversation by conversationId.
+     */
+    async listConversationMessages(conversationId, limit = 50) {
+        const client = await this.getClient();
+        const response = await client
+            .api('/me/messages')
+            .filter(`conversationId eq '${conversationId}'`)
+            .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,sentDateTime,isRead,hasAttachments,importance,flag,bodyPreview,conversationId,internetMessageId,parentFolderId')
+            .orderby('receivedDateTime asc')
+            .top(limit)
+            .get();
+        return response.value;
+    }
+    /**
+     * Gets a specific message with full body.
+     */
+    async getMessage(messageId) {
+        const client = await this.getClient();
+        try {
+            return await client
+                .api(`/me/messages/${messageId}`)
+                .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,sentDateTime,isRead,hasAttachments,importance,flag,body,bodyPreview,conversationId,internetMessageId,parentFolderId')
+                .get();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Gets message delta for incremental sync.
+     */
+    async getMessagesDelta(folderId, deltaLink) {
+        const client = await this.getClient();
+        let response;
+        if (deltaLink != null) {
+            response = await client.api(deltaLink).get();
+        }
+        else {
+            response = await client
+                .api(`/me/mailFolders/${folderId}/messages/delta`)
+                .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,sentDateTime,isRead,hasAttachments,importance,flag,bodyPreview,conversationId,internetMessageId,parentFolderId')
+                .top(50)
+                .get();
+        }
+        const messages = [...(response.value ?? [])];
+        let nextLink = response['@odata.nextLink'];
+        while (nextLink != null) {
+            const nextPage = await client.api(nextLink).get();
+            messages.push(...(nextPage.value ?? []));
+            nextLink = nextPage['@odata.nextLink'];
+        }
+        const newDeltaLink = response['@odata.deltaLink'] ?? '';
+        return { messages, deltaLink: newDeltaLink };
+    }
+    // ===========================================================================
+    // Mail Rules
+    // ===========================================================================
+    /**
+     * Lists all inbox mail rules.
+     */
+    async listMailRules() {
+        const client = await this.getClient();
+        const response = await client
+            .api('/me/mailFolders/inbox/messageRules')
+            .get();
+        return response.value;
+    }
+    /**
+     * Creates a new inbox mail rule.
+     */
+    async createMailRule(rule) {
+        const client = await this.getClient();
+        const result = await client
+            .api('/me/mailFolders/inbox/messageRules')
+            .post(rule);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Deletes an inbox mail rule.
+     */
+    async deleteMailRule(ruleId) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/mailFolders/inbox/messageRules/${ruleId}`)
+            .delete();
+        this.cache.clear();
+    }
+    // ===========================================================================
+    // Automatic Replies (Out of Office)
+    // ===========================================================================
+    /**
+     * Gets the automatic replies (OOF) settings.
+     */
+    async getAutomaticReplies() {
+        const client = await this.getClient();
+        return await client.api('/me/mailboxSettings/automaticRepliesSetting').get();
+    }
+    /**
+     * Sets the automatic replies (OOF) settings.
+     */
+    async setAutomaticReplies(settings) {
+        const client = await this.getClient();
+        await client.api('/me/mailboxSettings').patch({ automaticRepliesSetting: settings });
+    }
+    // ===========================================================================
+    // Mailbox Settings
+    // ===========================================================================
+    /**
+     * Gets the full mailbox settings for the current user.
+     */
+    async getMailboxSettings() {
+        const client = await this.getClient();
+        return await client.api('/me/mailboxSettings').get();
+    }
+    /**
+     * Updates mailbox settings for the current user.
+     */
+    async updateMailboxSettings(settings) {
+        const client = await this.getClient();
+        await client.api('/me/mailboxSettings').patch(settings);
+    }
+    // ===========================================================================
+    // Calendars
+    // ===========================================================================
+    /**
+     * Lists all calendars.
+     */
+    async listCalendars() {
+        const cacheKey = createCacheKey('listCalendars');
+        const cached = this.cache.get(cacheKey);
+        if (cached != null) {
+            return cached;
+        }
+        const client = await this.getClient();
+        const response = await client
+            .api('/me/calendars')
+            .select('id,name,color,isDefaultCalendar,canEdit')
+            .get();
+        const result = response.value;
+        this.cache.set(cacheKey, result, CacheTTL.FOLDERS);
+        return result;
+    }
+    // ===========================================================================
+    // Events
+    // ===========================================================================
+    /**
+     * Lists events with optional date range.
+     */
+    async listEvents(limit = 50, calendarId, startDate, endDate) {
+        const client = await this.getClient();
+        // If date range provided, use calendarView
+        if (startDate != null && endDate != null) {
+            const baseUrl = calendarId != null
+                ? `/me/calendars/${calendarId}/calendarView`
+                : '/me/calendarView';
+            const response = await client
+                .api(baseUrl)
+                .query({
+                startDateTime: startDate.toISOString(),
+                endDateTime: endDate.toISOString(),
+            })
+                .select('id,subject,start,end,location,isAllDay,organizer,attendees,body,recurrence,iCalUId')
+                .orderby('start/dateTime')
+                .top(limit)
+                .get();
+            return response.value;
+        }
+        // Otherwise, get upcoming events
+        const baseUrl = calendarId != null
+            ? `/me/calendars/${calendarId}/events`
+            : '/me/events';
+        const response = await client
+            .api(baseUrl)
+            .select('id,subject,start,end,location,isAllDay,organizer,attendees,body,recurrence,iCalUId')
+            .orderby('start/dateTime')
+            .top(limit)
+            .get();
+        return response.value;
+    }
+    /**
+     * Gets a specific event.
+     */
+    async getEvent(eventId) {
+        const client = await this.getClient();
+        try {
+            return await client
+                .api(`/me/events/${eventId}`)
+                .select('id,subject,start,end,location,isAllDay,organizer,attendees,body,recurrence,iCalUId')
+                .get();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Lists instances of a recurring event within a date range.
+     */
+    async listEventInstances(eventId, startDateTime, endDateTime) {
+        const client = await this.getClient();
+        const response = await client
+            .api(`/me/events/${eventId}/instances`)
+            .query({ startDateTime, endDateTime })
+            .select('id,subject,start,end,location,isAllDay,isCancelled,organizer,recurrence,bodyPreview')
+            .get();
+        return response.value;
+    }
+    // ===========================================================================
+    // Calendar Write Operations
+    // ===========================================================================
+    /**
+     * Creates a new calendar event.
+     */
+    async createEvent(event, calendarId) {
+        const client = await this.getClient();
+        const url = calendarId != null
+            ? `/me/calendars/${calendarId}/events`
+            : '/me/events';
+        const result = await client
+            .api(url)
+            .post(event);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Updates an existing calendar event.
+     */
+    async updateEvent(eventId, updates) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/events/${eventId}`)
+            .patch(updates);
+        this.cache.clear();
+    }
+    /**
+     * Deletes a calendar event.
+     */
+    async deleteEvent(eventId) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/events/${eventId}`)
+            .delete();
+        this.cache.clear();
+    }
+    /**
+     * Responds to a calendar event invitation.
+     */
+    async respondToEvent(eventId, response, sendResponse, comment) {
+        const client = await this.getClient();
+        const actionMap = {
+            accept: 'accept',
+            decline: 'decline',
+            tentative: 'tentativelyAccept',
+        };
+        const action = actionMap[response];
+        await client
+            .api(`/me/events/${eventId}/${action}`)
+            .post({ sendResponse, comment: comment ?? '' });
+        this.cache.clear();
+    }
+    // ===========================================================================
+    // Contacts
+    // ===========================================================================
+    /**
+     * Lists contacts with pagination.
+     */
+    async listContacts(limit = 50, skip = 0) {
+        const cacheKey = createCacheKey('listContacts', limit, skip);
+        const cached = this.cache.get(cacheKey);
+        if (cached != null) {
+            return cached;
+        }
+        const client = await this.getClient();
+        const response = await client
+            .api('/me/contacts')
+            .select('id,displayName,givenName,surname,middleName,nickName,companyName,jobTitle,department,emailAddresses,homePhones,businessPhones,mobilePhone,homeAddress,businessAddress,personalNotes')
+            .orderby('displayName')
+            .top(limit)
+            .skip(skip)
+            .get();
+        const result = response.value;
+        this.cache.set(cacheKey, result, CacheTTL.CONTACTS);
+        return result;
+    }
+    /**
+     * Searches contacts by display name.
+     */
+    async searchContacts(query, limit = 50) {
+        const client = await this.getClient();
+        const response = await client
+            .api('/me/contacts')
+            .filter(`contains(displayName,'${query}')`)
+            .select('id,displayName,givenName,surname,middleName,nickName,companyName,jobTitle,department,emailAddresses,homePhones,businessPhones,mobilePhone,homeAddress,businessAddress,personalNotes')
+            .top(limit)
+            .get();
+        return response.value;
+    }
+    /**
+     * Gets a specific contact.
+     */
+    async getContact(contactId) {
+        const client = await this.getClient();
+        try {
+            return await client
+                .api(`/me/contacts/${contactId}`)
+                .select('id,displayName,givenName,surname,middleName,nickName,companyName,jobTitle,department,emailAddresses,homePhones,businessPhones,mobilePhone,homeAddress,businessAddress,personalNotes')
+                .get();
+        }
+        catch {
+            return null;
+        }
+    }
+    // ===========================================================================
+    // Contact Write Operations
+    // ===========================================================================
+    /**
+     * Creates a new contact.
+     */
+    async createContact(contact) {
+        const client = await this.getClient();
+        const result = await client
+            .api('/me/contacts')
+            .post(contact);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Updates an existing contact.
+     */
+    async updateContact(contactId, updates) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/contacts/${contactId}`)
+            .patch(updates);
+        this.cache.clear();
+    }
+    /**
+     * Deletes a contact.
+     */
+    async deleteContact(contactId) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/contacts/${contactId}`)
+            .delete();
+        this.cache.clear();
+    }
+    // ===========================================================================
+    // Contact Photos
+    // ===========================================================================
+    /**
+     * Gets the photo for a contact as raw binary data.
+     */
+    async getContactPhoto(contactId) {
+        const client = await this.getClient();
+        return await client
+            .api(`/me/contacts/${contactId}/photo/$value`)
+            .get();
+    }
+    /**
+     * Sets or updates the photo for a contact.
+     */
+    async setContactPhoto(contactId, photoData, contentType) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/contacts/${contactId}/photo/$value`)
+            .header('Content-Type', contentType)
+            .put(photoData);
+        this.cache.clear();
+    }
+    // ===========================================================================
+    // Contact Folders
+    // ===========================================================================
+    /**
+     * Lists all contact folders.
+     */
+    async listContactFolders() {
+        const client = await this.getClient();
+        const response = await client.api('/me/contactFolders').get();
+        return response.value;
+    }
+    /**
+     * Creates a new contact folder.
+     */
+    async createContactFolder(displayName) {
+        const client = await this.getClient();
+        const result = await client.api('/me/contactFolders').post({ displayName });
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Deletes a contact folder.
+     */
+    async deleteContactFolder(folderId) {
+        const client = await this.getClient();
+        await client.api(`/me/contactFolders/${folderId}`).delete();
+        this.cache.clear();
+    }
+    /**
+     * Lists contacts in a specific contact folder.
+     */
+    async listContactsInFolder(folderId, limit = 100) {
+        const client = await this.getClient();
+        const response = await client
+            .api(`/me/contactFolders/${folderId}/contacts`)
+            .select('id,displayName,givenName,surname,emailAddresses,businessPhones,mobilePhone,jobTitle,companyName')
+            .top(limit)
+            .get();
+        return response.value;
+    }
+    // ===========================================================================
+    // Tasks (Microsoft To Do)
+    // ===========================================================================
+    /**
+     * Lists task lists.
+     */
+    async listTaskLists() {
+        const cacheKey = createCacheKey('listTaskLists');
+        const cached = this.cache.get(cacheKey);
+        if (cached != null) {
+            return cached;
+        }
+        const client = await this.getClient();
+        const response = await client
+            .api('/me/todo/lists')
+            .select('id,displayName,isOwner,isShared,wellknownListName')
+            .get();
+        const result = response.value;
+        this.cache.set(cacheKey, result, CacheTTL.FOLDERS);
+        return result;
+    }
+    /**
+     * Lists tasks in a task list.
+     */
+    async listTasks(taskListId, limit = 50, skip = 0, includeCompleted = true) {
+        const client = await this.getClient();
+        let api = client
+            .api(`/me/todo/lists/${taskListId}/tasks`)
+            .select('id,title,status,importance,dueDateTime,completedDateTime,body,createdDateTime,lastModifiedDateTime,isReminderOn,reminderDateTime')
+            .top(limit)
+            .skip(skip);
+        if (!includeCompleted) {
+            api = api.filter("status ne 'completed'");
+        }
+        const response = await api.get();
+        return response.value;
+    }
+    /**
+     * Lists all tasks across all task lists.
+     */
+    async listAllTasks(limit = 50, skip = 0, includeCompleted = true) {
+        const taskLists = await this.listTaskLists();
+        const allTasks = [];
+        for (const list of taskLists) {
+            if (list.id == null)
+                continue;
+            const tasks = await this.listTasks(list.id, 100, 0, includeCompleted);
+            for (const task of tasks) {
+                allTasks.push({ ...task, taskListId: list.id });
+            }
+        }
+        // Sort by due date, then slice for pagination
+        allTasks.sort((a, b) => {
+            if (a.dueDateTime == null && b.dueDateTime == null)
+                return 0;
+            if (a.dueDateTime == null)
+                return 1;
+            if (b.dueDateTime == null)
+                return -1;
+            return new Date(a.dueDateTime.dateTime ?? '').getTime() - new Date(b.dueDateTime.dateTime ?? '').getTime();
+        });
+        return allTasks.slice(skip, skip + limit);
+    }
+    /**
+     * Gets a specific task.
+     */
+    async getTask(taskListId, taskId) {
+        const client = await this.getClient();
+        try {
+            return await client
+                .api(`/me/todo/lists/${taskListId}/tasks/${taskId}`)
+                .select('id,title,status,importance,dueDateTime,completedDateTime,body,createdDateTime,lastModifiedDateTime,isReminderOn,reminderDateTime')
+                .get();
+        }
+        catch {
+            return null;
+        }
+    }
+    // ===========================================================================
+    // Write Operations
+    // ===========================================================================
+    /**
+     * Moves a message to a different folder.
+     */
+    async moveMessage(messageId, destinationFolderId) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/messages/${messageId}/move`)
+            .post({ destinationId: destinationFolderId });
+        this.cache.clear(); // Invalidate cache after mutation
+    }
+    /**
+     * Deletes a message (moves to Deleted Items).
+     */
+    async deleteMessage(messageId) {
+        const client = await this.getClient();
+        // Move to deletedItems well-known folder
+        await client
+            .api(`/me/messages/${messageId}/move`)
+            .post({ destinationId: 'deleteditems' });
+        this.cache.clear();
+    }
+    /**
+     * Archives a message (moves to Archive folder).
+     */
+    async archiveMessage(messageId) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/messages/${messageId}/move`)
+            .post({ destinationId: 'archive' });
+        this.cache.clear();
+    }
+    /**
+     * Moves a message to the Junk folder.
+     */
+    async junkMessage(messageId) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/messages/${messageId}/move`)
+            .post({ destinationId: 'junkemail' });
+        this.cache.clear();
+    }
+    /**
+     * Updates message properties (read status, flag, categories).
+     */
+    async updateMessage(messageId, updates) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/messages/${messageId}`)
+            .patch(updates);
+        this.cache.clear();
+    }
+    /**
+     * Creates a new mail folder.
+     */
+    async createMailFolder(displayName, parentFolderId) {
+        const client = await this.getClient();
+        const url = parentFolderId != null
+            ? `/me/mailFolders/${parentFolderId}/childFolders`
+            : '/me/mailFolders';
+        const result = await client
+            .api(url)
+            .post({ displayName });
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Deletes a mail folder.
+     */
+    async deleteMailFolder(folderId) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/mailFolders/${folderId}`)
+            .delete();
+        this.cache.clear();
+    }
+    /**
+     * Renames a mail folder.
+     */
+    async renameMailFolder(folderId, newName) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/mailFolders/${folderId}`)
+            .patch({ displayName: newName });
+        this.cache.clear();
+    }
+    /**
+     * Moves a mail folder to a new parent.
+     */
+    async moveMailFolder(folderId, destinationParentId) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/mailFolders/${folderId}/move`)
+            .post({ destinationId: destinationParentId });
+        this.cache.clear();
+    }
+    /**
+     * Deletes all messages in a folder.
+     */
+    async emptyMailFolder(folderId) {
+        const client = await this.getClient();
+        // Get all messages in the folder
+        let response = await client
+            .api(`/me/mailFolders/${folderId}/messages`)
+            .select('id')
+            .top(100)
+            .get();
+        // Delete each message
+        for (const message of response.value) {
+            if (message.id != null) {
+                await client
+                    .api(`/me/messages/${message.id}/move`)
+                    .post({ destinationId: 'deleteditems' });
+            }
+        }
+        // Handle pagination
+        while (response['@odata.nextLink'] != null) {
+            response = await client.api(response['@odata.nextLink']).get();
+            for (const message of response.value) {
+                if (message.id != null) {
+                    await client
+                        .api(`/me/messages/${message.id}/move`)
+                        .post({ destinationId: 'deleteditems' });
+                }
+            }
+        }
+        this.cache.clear();
+    }
+    // ===========================================================================
+    // Draft & Send Operations
+    // ===========================================================================
+    /**
+     * Creates a new draft message.
+     */
+    async createDraft(message) {
+        const client = await this.getClient();
+        const result = await client
+            .api('/me/messages')
+            .post(message);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Updates an existing draft message.
+     */
+    async updateDraft(messageId, updates) {
+        const client = await this.getClient();
+        const result = await client
+            .api(`/me/messages/${messageId}`)
+            .patch(updates);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Sends an existing draft message.
+     */
+    async sendDraft(messageId) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/messages/${messageId}/send`)
+            .post(null);
+        this.cache.clear();
+    }
+    /**
+     * Sends a new email directly without creating a draft.
+     */
+    async sendMail(message) {
+        const client = await this.getClient();
+        await client
+            .api('/me/sendMail')
+            .post({ message });
+        this.cache.clear();
+    }
+    /**
+     * Replies to a message, or replies to all recipients.
+     */
+    async replyMessage(messageId, comment, replyAll) {
+        const client = await this.getClient();
+        const action = replyAll ? 'replyAll' : 'reply';
+        await client
+            .api(`/me/messages/${messageId}/${action}`)
+            .post({ comment });
+        this.cache.clear();
+    }
+    /**
+     * Forwards a message to specified recipients.
+     */
+    async forwardMessage(messageId, toRecipients, comment) {
+        const client = await this.getClient();
+        const body = { toRecipients };
+        if (comment != null) {
+            body.comment = comment;
+        }
+        await client
+            .api(`/me/messages/${messageId}/forward`)
+            .post(body);
+        this.cache.clear();
+    }
+    /**
+     * Creates a reply draft for a message.
+     */
+    async createReplyDraft(messageId) {
+        const client = await this.getClient();
+        const result = await client
+            .api(`/me/messages/${messageId}/createReply`)
+            .post(null);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Creates a reply-all draft for a message.
+     */
+    async createReplyAllDraft(messageId) {
+        const client = await this.getClient();
+        const result = await client
+            .api(`/me/messages/${messageId}/createReplyAll`)
+            .post(null);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Creates a forward draft for a message.
+     */
+    async createForwardDraft(messageId) {
+        const client = await this.getClient();
+        const result = await client
+            .api(`/me/messages/${messageId}/createForward`)
+            .post(null);
+        this.cache.clear();
+        return result;
+    }
+    // ---------------------------------------------------------------------------
+    // Calendar Scheduling
+    // ---------------------------------------------------------------------------
+    /**
+     * Gets the free/busy schedule for one or more people.
+     * POST /me/calendar/getSchedule
+     */
+    async getSchedule(params) {
+        const client = await this.getClient();
+        const response = await client.api('/me/calendar/getSchedule').post(params);
+        return response.value;
+    }
+    /**
+     * Suggests meeting times for a set of attendees.
+     * POST /me/findMeetingTimes
+     */
+    async findMeetingTimes(params) {
+        const client = await this.getClient();
+        return (await client.api('/me/findMeetingTimes').post(params));
+    }
+    // ===========================================================================
+    // Attachment Operations
+    // ===========================================================================
+    /**
+     * Lists attachments on a message.
+     */
+    async listAttachments(messageId) {
+        const client = await this.getClient();
+        const response = await client
+            .api(`/me/messages/${messageId}/attachments`)
+            .select('id,name,size,contentType,isInline')
+            .get();
+        return response.value;
+    }
+    /**
+     * Gets a specific attachment with full content (including contentBytes).
+     */
+    async getAttachment(messageId, attachmentId) {
+        const client = await this.getClient();
+        return await client
+            .api(`/me/messages/${messageId}/attachments/${attachmentId}`)
+            .get();
+    }
+    /**
+     * Adds an inline base64 attachment to a message (<= 3MB).
+     */
+    async addAttachment(messageId, attachment) {
+        const client = await this.getClient();
+        const result = await client
+            .api(`/me/messages/${messageId}/attachments`)
+            .post(attachment);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Creates an upload session for large file attachments (> 3MB).
+     */
+    async createUploadSession(messageId, body) {
+        const client = await this.getClient();
+        return await client
+            .api(`/me/messages/${messageId}/attachments/createUploadSession`)
+            .post(body);
+    }
+    // ===========================================================================
+    // Tasks (Microsoft To Do) - continued
+    // ===========================================================================
+    /**
+     * Searches tasks by title.
+     */
+    async searchTasks(query, limit = 50) {
+        const allTasks = await this.listAllTasks(1000, 0, true);
+        const queryLower = query.toLowerCase();
+        const matched = allTasks.filter((task) => task.title?.toLowerCase().includes(queryLower) ?? false);
+        return matched.slice(0, limit);
+    }
+    // ===========================================================================
+    // Task Write Operations
+    // ===========================================================================
+    /**
+     * Creates a new task in a task list.
+     */
+    async createTask(taskListId, task) {
+        const client = await this.getClient();
+        const result = await client
+            .api(`/me/todo/lists/${taskListId}/tasks`)
+            .post(task);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Updates an existing task.
+     */
+    async updateTask(taskListId, taskId, updates) {
+        const client = await this.getClient();
+        const result = await client
+            .api(`/me/todo/lists/${taskListId}/tasks/${taskId}`)
+            .patch(updates);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Deletes a task.
+     */
+    async deleteTask(taskListId, taskId) {
+        const client = await this.getClient();
+        await client
+            .api(`/me/todo/lists/${taskListId}/tasks/${taskId}`)
+            .delete();
+        this.cache.clear();
+    }
+    /**
+     * Creates a new task list.
+     */
+    async createTaskList(displayName) {
+        const client = await this.getClient();
+        const result = await client
+            .api('/me/todo/lists')
+            .post({ displayName });
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Updates a task list (e.g. rename).
+     */
+    async updateTaskList(listId, updates) {
+        const client = await this.getClient();
+        await client.api(`/me/todo/lists/${listId}`).patch(updates);
+        this.cache.clear();
+    }
+    /**
+     * Deletes a task list.
+     */
+    async deleteTaskList(listId) {
+        const client = await this.getClient();
+        await client.api(`/me/todo/lists/${listId}`).delete();
+        this.cache.clear();
+    }
+    // ===========================================================================
+    // Master Categories
+    // ===========================================================================
+    /**
+     * Lists all master categories.
+     */
+    async listMasterCategories() {
+        const client = await this.getClient();
+        const response = await client.api('/me/outlook/masterCategories').get();
+        return response.value;
+    }
+    /**
+     * Creates a new master category.
+     */
+    async createMasterCategory(displayName, color) {
+        const client = await this.getClient();
+        const result = await client.api('/me/outlook/masterCategories').post({ displayName, color });
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Deletes a master category.
+     */
+    async deleteMasterCategory(categoryId) {
+        const client = await this.getClient();
+        await client.api(`/me/outlook/masterCategories/${categoryId}`).delete();
+        this.cache.clear();
+    }
+    // ===========================================================================
+    // Focused Inbox Overrides
+    // ===========================================================================
+    /**
+     * Lists all focused inbox overrides.
+     */
+    async listFocusedOverrides() {
+        const client = await this.getClient();
+        const response = await client.api('/me/inferenceClassification/overrides').get();
+        return response.value;
+    }
+    /**
+     * Creates a focused inbox override.
+     */
+    async createFocusedOverride(senderAddress, classifyAs) {
+        const client = await this.getClient();
+        const result = await client.api('/me/inferenceClassification/overrides').post({
+            classifyAs,
+            senderEmailAddress: { address: senderAddress },
+        });
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Deletes a focused inbox override.
+     */
+    async deleteFocusedOverride(overrideId) {
+        const client = await this.getClient();
+        await client.api(`/me/inferenceClassification/overrides/${overrideId}`).delete();
+        this.cache.clear();
+    }
+    // ===========================================================================
+    // Message Headers & MIME
+    // ===========================================================================
+    /**
+     * Gets internet message headers for a message.
+     */
+    async getMessageHeaders(messageId) {
+        const client = await this.getClient();
+        const message = await client
+            .api(`/me/messages/${messageId}`)
+            .select('internetMessageHeaders')
+            .get();
+        return (message.internetMessageHeaders ?? []);
+    }
+    /**
+     * Gets the MIME content of a message.
+     */
+    async getMessageMime(messageId) {
+        const client = await this.getClient();
+        return await client.api(`/me/messages/${messageId}/$value`).get();
+    }
+    // ===========================================================================
+    // Calendar Groups
+    // ===========================================================================
+    /**
+     * Lists all calendar groups.
+     */
+    async listCalendarGroups() {
+        const client = await this.getClient();
+        const response = await client.api('/me/calendarGroups').get();
+        return response.value;
+    }
+    /**
+     * Creates a new calendar group.
+     */
+    async createCalendarGroup(name) {
+        const client = await this.getClient();
+        const result = await client.api('/me/calendarGroups').post({ name });
+        this.cache.clear();
+        return result;
+    }
+    // ===========================================================================
+    // Calendar Permissions
+    // ===========================================================================
+    /**
+     * Lists all permissions for a calendar.
+     */
+    async listCalendarPermissions(calendarId) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/calendars/${calendarId}/calendarPermissions`).get();
+        return response.value;
+    }
+    /**
+     * Creates a calendar permission (shares a calendar).
+     */
+    async createCalendarPermission(calendarId, permission) {
+        const client = await this.getClient();
+        const result = await client.api(`/me/calendars/${calendarId}/calendarPermissions`).post(permission);
+        this.cache.clear();
+        return result;
+    }
+    /**
+     * Deletes a calendar permission.
+     */
+    async deleteCalendarPermission(calendarId, permissionId) {
+        const client = await this.getClient();
+        await client.api(`/me/calendars/${calendarId}/calendarPermissions/${permissionId}`).delete();
+        this.cache.clear();
+    }
+    // ===========================================================================
+    // Room Lists & Rooms
+    // ===========================================================================
+    /**
+     * GET /me/findRoomLists
+     */
+    async listRoomLists() {
+        const client = await this.getClient();
+        const response = await client.api('/me/findRoomLists').get();
+        return response.value;
+    }
+    /**
+     * GET /me/findRooms or /me/findRooms(RoomList='...')
+     */
+    async listRooms(roomListEmail) {
+        const client = await this.getClient();
+        const endpoint = roomListEmail != null
+            ? `/me/findRooms(RoomList='${roomListEmail}')`
+            : '/me/findRooms';
+        const response = await client.api(endpoint).get();
+        return response.value;
+    }
+    // ===========================================================================
+    // Mail Tips
+    // ===========================================================================
+    /**
+     * Gets mail tips for the specified email addresses.
+     */
+    async getMailTips(emailAddresses) {
+        const client = await this.getClient();
+        const response = await client.api('/me/getMailTips').post({
+            emailAddresses,
+            mailTipsOptions: 'automaticReplies,mailboxFullStatus,maxMessageSize,deliveryRestriction,externalMemberCount',
+        });
+        return response.value;
+    }
+    // ===========================================================================
+    // Teams
+    // ===========================================================================
+    /**
+     * Lists all teams the current user has joined.
+     */
+    async listJoinedTeams() {
+        const client = await this.getClient();
+        const response = await client.api('/me/joinedTeams').get();
+        return response.value;
+    }
+    /**
+     * Lists all channels in a team.
+     */
+    async listChannels(teamId) {
+        const client = await this.getClient();
+        const response = await client.api(`/teams/${teamId}/channels`).get();
+        return response.value;
+    }
+    /**
+     * Gets a specific channel.
+     */
+    async getChannel(teamId, channelId) {
+        const client = await this.getClient();
+        return await client.api(`/teams/${teamId}/channels/${channelId}`).get();
+    }
+    /**
+     * Creates a new channel in a team.
+     */
+    async createChannel(teamId, displayName, description) {
+        const client = await this.getClient();
+        const body = { displayName };
+        if (description != null)
+            body['description'] = description;
+        return await client.api(`/teams/${teamId}/channels`).post(body);
+    }
+    /**
+     * Updates a channel's properties.
+     */
+    async updateChannel(teamId, channelId, updates) {
+        const client = await this.getClient();
+        await client.api(`/teams/${teamId}/channels/${channelId}`).patch(updates);
+    }
+    /**
+     * Deletes a channel.
+     */
+    async deleteChannel(teamId, channelId) {
+        const client = await this.getClient();
+        await client.api(`/teams/${teamId}/channels/${channelId}`).delete();
+    }
+    /**
+     * Lists members of a team.
+     */
+    async listTeamMembers(teamId) {
+        const client = await this.getClient();
+        const response = await client.api(`/teams/${teamId}/members`).get();
+        return response.value;
+    }
+    // ===========================================================================
+    // Channel Messages
+    // ===========================================================================
+    /**
+     * Lists recent messages in a channel.
+     */
+    async listChannelMessages(teamId, channelId, top = 25) {
+        const client = await this.getClient();
+        const response = await client.api(`/teams/${teamId}/channels/${channelId}/messages`).top(top).get();
+        return response.value;
+    }
+    /**
+     * Gets a specific channel message.
+     */
+    async getChannelMessage(teamId, channelId, messageId) {
+        const client = await this.getClient();
+        return await client.api(`/teams/${teamId}/channels/${channelId}/messages/${messageId}`).get();
+    }
+    /**
+     * Lists replies to a channel message.
+     */
+    async listChannelMessageReplies(teamId, channelId, messageId) {
+        const client = await this.getClient();
+        const response = await client.api(`/teams/${teamId}/channels/${channelId}/messages/${messageId}/replies`).get();
+        return response.value;
+    }
+    /**
+     * Sends a new message to a channel.
+     */
+    async sendChannelMessage(teamId, channelId, body, contentType = 'html') {
+        const client = await this.getClient();
+        return await client.api(`/teams/${teamId}/channels/${channelId}/messages`).post({
+            body: { contentType, content: body },
+        });
+    }
+    /**
+     * Replies to a channel message.
+     */
+    async replyToChannelMessage(teamId, channelId, messageId, body, contentType = 'html') {
+        const client = await this.getClient();
+        return await client.api(`/teams/${teamId}/channels/${channelId}/messages/${messageId}/replies`).post({
+            body: { contentType, content: body },
+        });
+    }
+    // ===========================================================================
+    // Chats
+    // ===========================================================================
+    async listChats(top = 25) {
+        const client = await this.getClient();
+        const response = await client.api('/me/chats')
+            .top(top)
+            .orderby('lastMessagePreview/createdDateTime desc')
+            .expand('lastMessagePreview')
+            .get();
+        return response.value;
+    }
+    async getChat(chatId) {
+        const client = await this.getClient();
+        return await client.api(`/me/chats/${chatId}`).get();
+    }
+    async listChatMessages(chatId, top = 25) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/chats/${chatId}/messages`).top(top).get();
+        return response.value;
+    }
+    async sendChatMessage(chatId, body, contentType = 'html') {
+        const client = await this.getClient();
+        return await client.api(`/me/chats/${chatId}/messages`).post({
+            body: { contentType, content: body },
+        });
+    }
+    async getChatMessage(chatId, messageId) {
+        const client = await this.getClient();
+        return await client.api(`/me/chats/${chatId}/messages/${messageId}`).get();
+    }
+    // Channel message reactions
+    async setChannelMessageReaction(teamId, channelId, messageId, reactionType) {
+        const client = await this.getClient();
+        await client.api(`/teams/${teamId}/channels/${channelId}/messages/${messageId}/setReaction`)
+            .post({ reactionType });
+    }
+    async unsetChannelMessageReaction(teamId, channelId, messageId, reactionType) {
+        const client = await this.getClient();
+        await client.api(`/teams/${teamId}/channels/${channelId}/messages/${messageId}/unsetReaction`)
+            .post({ reactionType });
+    }
+    // Chat message reactions
+    async setChatMessageReaction(chatId, messageId, reactionType) {
+        const client = await this.getClient();
+        await client.api(`/chats/${chatId}/messages/${messageId}/setReaction`)
+            .post({ reactionType });
+    }
+    async unsetChatMessageReaction(chatId, messageId, reactionType) {
+        const client = await this.getClient();
+        await client.api(`/chats/${chatId}/messages/${messageId}/unsetReaction`)
+            .post({ reactionType });
+    }
+    async listChatMembers(chatId) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/chats/${chatId}/members`).get();
+        return response.value;
+    }
+    // ===========================================================================
+    // Checklist Items
+    // ===========================================================================
+    /**
+     * Lists checklist items on a task.
+     */
+    async listChecklistItems(taskListId, taskId) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/todo/lists/${taskListId}/tasks/${taskId}/checklistItems`).get();
+        return response.value;
+    }
+    /**
+     * Creates a checklist item on a task.
+     */
+    async createChecklistItem(taskListId, taskId, displayName, isChecked = false) {
+        const client = await this.getClient();
+        return await client.api(`/me/todo/lists/${taskListId}/tasks/${taskId}/checklistItems`).post({
+            displayName,
+            isChecked,
+        });
+    }
+    /**
+     * Updates a checklist item.
+     */
+    async updateChecklistItem(taskListId, taskId, checklistItemId, updates) {
+        const client = await this.getClient();
+        await client.api(`/me/todo/lists/${taskListId}/tasks/${taskId}/checklistItems/${checklistItemId}`).patch(updates);
+    }
+    /**
+     * Deletes a checklist item.
+     */
+    async deleteChecklistItem(taskListId, taskId, checklistItemId) {
+        const client = await this.getClient();
+        await client.api(`/me/todo/lists/${taskListId}/tasks/${taskId}/checklistItems/${checklistItemId}`).delete();
+    }
+    // ===========================================================================
+    // Linked Resources
+    // ===========================================================================
+    async listLinkedResources(taskListId, taskId) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/todo/lists/${taskListId}/tasks/${taskId}/linkedResources`).get();
+        return response.value;
+    }
+    async createLinkedResource(taskListId, taskId, webUrl, applicationName, displayName) {
+        const client = await this.getClient();
+        const body = { webUrl, applicationName };
+        if (displayName != null)
+            body['displayName'] = displayName;
+        return await client.api(`/me/todo/lists/${taskListId}/tasks/${taskId}/linkedResources`).post(body);
+    }
+    async deleteLinkedResource(taskListId, taskId, linkedResourceId) {
+        const client = await this.getClient();
+        await client.api(`/me/todo/lists/${taskListId}/tasks/${taskId}/linkedResources/${linkedResourceId}`).delete();
+    }
+    // ===========================================================================
+    // Task Attachments
+    // ===========================================================================
+    async listTaskAttachments(taskListId, taskId) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/todo/lists/${taskListId}/tasks/${taskId}/attachments`).get();
+        return response.value;
+    }
+    async createTaskAttachment(taskListId, taskId, name, contentBytes, contentType = 'application/octet-stream') {
+        const client = await this.getClient();
+        return await client.api(`/me/todo/lists/${taskListId}/tasks/${taskId}/attachments`).post({
+            '@odata.type': '#microsoft.graph.taskFileAttachment',
+            name,
+            contentBytes,
+            contentType,
+        });
+    }
+    async deleteTaskAttachment(taskListId, taskId, attachmentId) {
+        const client = await this.getClient();
+        await client.api(`/me/todo/lists/${taskListId}/tasks/${taskId}/attachments/${attachmentId}`).delete();
+    }
+    // ===========================================================================
+    // Planner
+    // ===========================================================================
+    async listPlans() {
+        const client = await this.getClient();
+        const response = await client.api('/me/planner/plans').get();
+        return response.value;
+    }
+    async getPlan(planId) {
+        const client = await this.getClient();
+        return await client.api(`/planner/plans/${planId}`).get();
+    }
+    async createPlan(title, groupId) {
+        const client = await this.getClient();
+        return await client.api('/planner/plans').post({
+            title,
+            owner: groupId,
+            container: { url: `https://graph.microsoft.com/v1.0/groups/${groupId}`, type: 'group' },
+        });
+    }
+    async updatePlan(planId, updates, etag) {
+        const client = await this.getClient();
+        return await client.api(`/planner/plans/${planId}`).header('If-Match', etag).patch(updates);
+    }
+    async listBuckets(planId) {
+        const client = await this.getClient();
+        const response = await client.api(`/planner/plans/${planId}/buckets`).get();
+        return response.value;
+    }
+    async createBucket(planId, name) {
+        const client = await this.getClient();
+        return await client.api('/planner/buckets').post({ planId, name });
+    }
+    async updateBucket(bucketId, updates, etag) {
+        const client = await this.getClient();
+        return await client.api(`/planner/buckets/${bucketId}`).header('If-Match', etag).patch(updates);
+    }
+    async deleteBucket(bucketId, etag) {
+        const client = await this.getClient();
+        await client.api(`/planner/buckets/${bucketId}`).header('If-Match', etag).delete();
+    }
+    // ===========================================================================
+    // Planner Tasks
+    // ===========================================================================
+    async listPlannerTasks(planId) {
+        const client = await this.getClient();
+        const response = await client.api(`/planner/plans/${planId}/tasks`).get();
+        return response.value;
+    }
+    async getPlannerTask(taskId) {
+        const client = await this.getClient();
+        return await client.api(`/planner/tasks/${taskId}`).get();
+    }
+    async createPlannerTask(task) {
+        const client = await this.getClient();
+        return await client.api('/planner/tasks').post(task);
+    }
+    async updatePlannerTask(taskId, updates, etag) {
+        const client = await this.getClient();
+        return await client.api(`/planner/tasks/${taskId}`).header('If-Match', etag).patch(updates);
+    }
+    async deletePlannerTask(taskId, etag) {
+        const client = await this.getClient();
+        await client.api(`/planner/tasks/${taskId}`).header('If-Match', etag).delete();
+    }
+    async getPlannerTaskDetails(taskId) {
+        const client = await this.getClient();
+        return await client.api(`/planner/tasks/${taskId}/details`).get();
+    }
+    async updatePlannerTaskDetails(taskId, updates, etag) {
+        const client = await this.getClient();
+        return await client.api(`/planner/tasks/${taskId}/details`).header('If-Match', etag).patch(updates);
+    }
+    // ===========================================================================
+    // People & Presence
+    // ===========================================================================
+    async listRelevantPeople(top = 25) {
+        const client = await this.getClient();
+        const response = await client.api('/me/people').top(top).get();
+        return response.value;
+    }
+    async searchPeople(query, top = 25) {
+        const client = await this.getClient();
+        const response = await client.api('/me/people').search('"' + query + '"').top(top).get();
+        return response.value;
+    }
+    async getManager() {
+        const client = await this.getClient();
+        return await client.api('/me/manager').get();
+    }
+    async getDirectReports() {
+        const client = await this.getClient();
+        const response = await client.api('/me/directReports').get();
+        return response.value;
+    }
+    async getUserProfile(identifier) {
+        const client = await this.getClient();
+        return await client.api(`/users/${identifier}`).get();
+    }
+    async getUserPhoto(identifier) {
+        const client = await this.getClient();
+        return await client.api(`/users/${identifier}/photo/$value`).get();
+    }
+    async getUserPresence(identifier) {
+        const client = await this.getClient();
+        return await client.api(`/users/${identifier}/presence`).get();
+    }
+    async getUsersPresence(userIds) {
+        const client = await this.getClient();
+        const response = await client.api('/communications/getPresencesByUserId').post({ ids: userIds });
+        return response.value;
+    }
+    /**
+     * Sends multiple requests in a single $batch call to the Graph API.
+     * Automatically splits into multiple batches if there are more than 20 requests.
+     */
+    async batchRequests(requests) {
+        const client = await this.getClient();
+        const batches = splitIntoBatches(requests);
+        const allResults = new Map();
+        for (const batch of batches) {
+            const payload = buildBatchPayload(batch);
+            const response = await client.api('/$batch').post(payload);
+            const results = parseBatchResponse(response);
+            for (const [id, result] of results) {
+                allResults.set(id, result);
+            }
+        }
+        return allResults;
+    }
+    // ===========================================================================
+    // Online Meetings
+    // ===========================================================================
+    async listOnlineMeetings(limit = 20) {
+        const client = await this.getClient();
+        const response = await client.api('/me/onlineMeetings')
+            .top(limit)
+            .orderby('startDateTime desc')
+            .get();
+        return response.value;
+    }
+    async getOnlineMeeting(meetingId) {
+        const client = await this.getClient();
+        return await client.api(`/me/onlineMeetings/${meetingId}`).get();
+    }
+    async listMeetingRecordings(meetingId) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/onlineMeetings/${meetingId}/recordings`).get();
+        return response.value;
+    }
+    async getMeetingRecordingContent(meetingId, recordingId) {
+        const client = await this.getClient();
+        return await client.api(`/me/onlineMeetings/${meetingId}/recordings/${recordingId}/content`).get();
+    }
+    async listMeetingTranscripts(meetingId) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/onlineMeetings/${meetingId}/transcripts`).get();
+        return response.value;
+    }
+    async getMeetingTranscriptContent(meetingId, transcriptId, format = 'text/vtt') {
+        const client = await this.getClient();
+        return await client.api(`/me/onlineMeetings/${meetingId}/transcripts/${transcriptId}/content`)
+            .header('Accept', format)
+            .get();
+    }
+    // ===========================================================================
+    // Excel Online (Workbook)
+    // ===========================================================================
+    /**
+     * Lists worksheets in an Excel workbook.
+     */
+    async listWorksheets(driveItemId) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/drive/items/${driveItemId}/workbook/worksheets`).get();
+        return response.value;
+    }
+    /**
+     * Gets cell values for a specific range in a worksheet.
+     */
+    async getWorksheetRange(driveItemId, worksheetName, range) {
+        const client = await this.getClient();
+        return await client.api(`/me/drive/items/${driveItemId}/workbook/worksheets/${encodeURIComponent(worksheetName)}/range(address='${encodeURIComponent(range)}')`).get();
+    }
+    /**
+     * Gets the used range (all data) for a worksheet.
+     */
+    async getUsedRange(driveItemId, worksheetName) {
+        const client = await this.getClient();
+        return await client.api(`/me/drive/items/${driveItemId}/workbook/worksheets/${encodeURIComponent(worksheetName)}/usedRange`).get();
+    }
+    /**
+     * Updates cell values for a specific range in a worksheet.
+     */
+    async updateWorksheetRange(driveItemId, worksheetName, range, values) {
+        const client = await this.getClient();
+        return await client.api(`/me/drive/items/${driveItemId}/workbook/worksheets/${encodeURIComponent(worksheetName)}/range(address='${encodeURIComponent(range)}')`).patch({ values });
+    }
+    /**
+     * Gets rows from a named table in an Excel workbook.
+     */
+    async getTableData(driveItemId, tableName) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/drive/items/${driveItemId}/workbook/tables/${encodeURIComponent(tableName)}/rows`).get();
+        return response.value;
+    }
+    // ===========================================================================
+    // OneDrive
+    // ===========================================================================
+    async listDriveItems(itemId) {
+        const client = await this.getClient();
+        const apiPath = itemId != null ? `/me/drive/items/${itemId}/children` : '/me/drive/root/children';
+        const response = await client.api(apiPath).get();
+        return response.value;
+    }
+    async searchDriveItems(query, limit = 25) {
+        const client = await this.getClient();
+        const response = await client.api(`/me/drive/root/search(q='${encodeURIComponent(query)}')`).top(limit).get();
+        return response.value;
+    }
+    async getDriveItem(itemId) {
+        const client = await this.getClient();
+        return await client.api(`/me/drive/items/${itemId}`).get();
+    }
+    async downloadDriveItem(itemId) {
+        const client = await this.getClient();
+        return await client.api(`/me/drive/items/${itemId}/content`).get();
+    }
+    async uploadDriveItem(parentPath, fileName, content) {
+        const client = await this.getClient();
+        return await client.api(`/me/drive/root:/${parentPath}/${fileName}:/content`)
+            .header('Content-Type', 'application/octet-stream')
+            .put(content);
+    }
+    async listRecentDriveItems() {
+        const client = await this.getClient();
+        const response = await client.api('/me/drive/recent').get();
+        return response.value;
+    }
+    async listSharedWithMe() {
+        const client = await this.getClient();
+        const response = await client.api('/me/drive/sharedWithMe').get();
+        return response.value;
+    }
+    async createSharingLink(itemId, type, scope) {
+        const client = await this.getClient();
+        return await client.api(`/me/drive/items/${itemId}/createLink`).post({ type, scope });
+    }
+    async deleteDriveItem(itemId) {
+        const client = await this.getClient();
+        await client.api(`/me/drive/items/${itemId}`).delete();
+    }
+    // ===========================================================================
+    // SharePoint Sites & Document Libraries
+    // ===========================================================================
+    /**
+     * Lists sites the current user follows.
+     */
+    async listFollowedSites() {
+        const client = await this.getClient();
+        const response = await client.api('/me/followedSites').get();
+        return response.value;
+    }
+    /**
+     * Searches for SharePoint sites by keyword.
+     */
+    async searchSites(query) {
+        const client = await this.getClient();
+        const response = await client.api(`/sites?search=${encodeURIComponent(query)}`).get();
+        return response.value;
+    }
+    /**
+     * Gets a specific SharePoint site by ID.
+     */
+    async getSite(siteId) {
+        const client = await this.getClient();
+        return await client.api(`/sites/${siteId}`).get();
+    }
+    /**
+     * Lists document libraries (drives) for a SharePoint site.
+     */
+    async listDocumentLibraries(siteId) {
+        const client = await this.getClient();
+        const response = await client.api(`/sites/${siteId}/drives`).get();
+        return response.value;
+    }
+    /**
+     * Lists items in a document library or folder.
+     */
+    async listLibraryItems(driveId, itemId) {
+        const client = await this.getClient();
+        const apiPath = itemId != null ? `/drives/${driveId}/items/${itemId}/children` : `/drives/${driveId}/root/children`;
+        const response = await client.api(apiPath).get();
+        return response.value;
+    }
+    /**
+     * Downloads a file from a document library.
+     */
+    async downloadLibraryFile(driveId, itemId) {
+        const client = await this.getClient();
+        return await client.api(`/drives/${driveId}/items/${itemId}/content`).get();
+    }
+}
+/**
+ * Creates a new Graph client instance.
+ */
+export function createGraphClient(deviceCodeCallback) {
+    return new GraphClient(deviceCodeCallback);
+}
+//# sourceMappingURL=graph-client.js.map