@checkfirst/nestjs-outlook 2.0.0 → 3.1.0

package/README.md

@@ -18,6 +18,7 @@ An opinionated NestJS module for Microsoft Outlook integration that provides eas
 
 - 🔄 Simplified Microsoft OAuth flow
 - 📅 Calendar events management
+- 📧 Email sending capabilities
 - 🔔 Real-time webhooks for changes
 - 🔐 Secure token storage and refresh
 
@@ -79,7 +80,20 @@ export class CreateOutlookTables1697025846000 implements MigrationInterface {
 
 You can customize this migration to match your database dialect (PostgreSQL, MySQL, etc.) if needed.
 
-### 2. Import Required Modules
+### 2. Microsoft App Registration
+
+Register your application in the Azure Portal to get a client ID and secret:
+
+1. Go to the [Azure Portal](https://portal.azure.com/)
+2. Navigate to Azure Active Directory > App registrations
+3. Create a new registration
+4. Configure redirects to include your callback URL
+5. Add the following Microsoft Graph API permissions:
+   - `Calendars.ReadWrite` - For calendar operations
+   - `Mail.Send` - For sending emails
+   - `offline_access` - For refresh tokens
+
+### 3. Import Required Modules
 
 Register the module in your NestJS application and include the module entities in TypeORM:
 
@@ -122,34 +136,154 @@ const outlookPackagePath = path.dirname(require.resolve('@checkfirst/nestjs-outl
 export class AppModule {}
 ```
 
-### 3. Create a Login Controller
+### 4. Create an Auth Controller
 
-Create a controller to handle Microsoft authentication:
+The library provides a MicrosoftAuthController for handling authentication, but you can also create your own:
 
 ```typescript
-export class CalendarController {
+import { Controller, Get, Req } from '@nestjs/common';
+import { MicrosoftAuthService, PermissionScope } from '@checkfirst/nestjs-outlook';
+
+@Controller('auth')
+export class AuthController {
   constructor(
     private readonly microsoftAuthService: MicrosoftAuthService
   ) {}
 
-  @UseGuards(AuthGuard)
-  @Get('auth/microsoft/login')
-  async login(@Req() req: Request) {
-    const user = req.user as UserTokenPayload;
-    if (!user?.id) {
-      throw new ForbiddenException('User not authenticated');
-    }
+  @Get('microsoft/login')
+  async login(@Req() req: any) {
+    // In a real application, get the user ID from your authentication system
+    const userId = req.user?.id.toString() || '1';
         
-    // Get the login URL from the Microsoft auth service
-    return await this.microsoftAuthService.getLoginUrl(user.id.toString());
+    // Get the login URL with specific permission scopes
+    return await this.microsoftAuthService.getLoginUrl(userId, [
+      PermissionScope.CALENDAR_READ,
+      PermissionScope.EMAIL_READ,
+      PermissionScope.EMAIL_SEND
+    ]);
   }
 }
 ```
 
-## Available Services
+## Permission Scopes
+
+The library provides a flexible permission system that allows you to request only the specific permissions your application needs:
+
+```typescript
+import { PermissionScope } from '@checkfirst/nestjs-outlook';
+
+// Available permission scopes:
+PermissionScope.CALENDAR_READ      // Read-only access to calendars
+PermissionScope.CALENDAR_WRITE     // Read-write access to calendars
+PermissionScope.EMAIL_READ         // Read-only access to emails
+PermissionScope.EMAIL_WRITE        // Read-write access to emails
+PermissionScope.EMAIL_SEND         // Permission to send emails
+```
+
+When requesting login URLs, you can specify exactly which permissions you need:
 
-- `OutlookService` - Main service for Microsoft Graph API operations on Outlook
-- `MicrosoftAuthService` - For authentication and token management
+```typescript
+// For a calendar-only app
+const loginUrl = await microsoftAuthService.getLoginUrl(userId, [
+  PermissionScope.CALENDAR_READ
+]);
+
+// For an email-only app
+const loginUrl = await microsoftAuthService.getLoginUrl(userId, [
+  PermissionScope.EMAIL_SEND
+]);
+```
+
+The system will automatically include the necessary base permissions (`offline_access` and `User.Read`) and map your requested permissions to the appropriate Microsoft Graph API scopes.
+
+## Available Services and Controllers
+
+The library provides specialized services and controllers for Microsoft Graph API operations:
+
+### 1. MicrosoftAuthService and MicrosoftAuthController
+
+Handle authentication, token management, and OAuth flow:
+
+```typescript
+// Initiate the OAuth flow - redirects user to Microsoft login
+const loginUrl = await microsoftAuthService.getLoginUrl(userId);
+
+// Exchange OAuth code for tokens (used in callback endpoint)
+const tokens = await microsoftAuthService.exchangeCodeForToken(code, state);
+
+// Refresh an expired access token
+const newTokens = await microsoftAuthService.refreshAccessToken(refreshToken, userId);
+
+// Check if a token is expired
+const isExpired = microsoftAuthService.isTokenExpired(tokenExpiryDate);
+```
+
+### 2. CalendarService and CalendarController
+
+Manage calendar operations with Microsoft Graph API:
+
+```typescript
+// Create a calendar event
+const event = {
+  subject: 'Team Meeting',
+  start: {
+    dateTime: '2023-06-01T10:00:00',
+    timeZone: 'UTC',
+  },
+  end: {
+    dateTime: '2023-06-01T11:00:00',
+    timeZone: 'UTC',
+  },
+};
+
+const result = await calendarService.createEvent(
+  event,
+  accessToken,
+  refreshToken,
+  tokenExpiry,
+  userId,
+  calendarId
+);
+
+// Get user's default calendar ID
+const calendarId = await calendarService.getDefaultCalendarId(accessToken);
+
+// Create webhook subscription for calendar events
+await calendarService.createWebhookSubscription(userId, accessToken, refreshToken);
+```
+
+The CalendarController provides a webhook endpoint at `/calendar/webhook` for receiving notifications from Microsoft Graph about calendar changes.
+
+### 3. EmailService
+
+Provides email sending capabilities via Microsoft Graph API:
+
+```typescript
+// Create email message
+const message = {
+  subject: 'Hello from NestJS Outlook',
+  body: {
+    contentType: 'HTML',
+    content: '<p>This is the email body</p>'
+  },
+  toRecipients: [
+    {
+      emailAddress: {
+        address: 'recipient@example.com'
+      }
+    }
+  ]
+};
+
+// Send the email
+const result = await emailService.sendEmail(
+  message,
+  accessToken,
+  refreshToken,
+  tokenExpiry,
+  userId
+);
+```
 
 ## Events
 
@@ -172,31 +306,72 @@ You can listen to these events in your application using the `@OnEvent` decorato
 ```typescript
 import { Injectable } from '@nestjs/common';
 import { OnEvent } from '@nestjs/event-emitter';
-import { OutlookEventTypes, OutlookResourceData } from '@checkfirst/nestjs-outlook';
+import { OutlookEventTypes, OutlookResourceData, TokenResponse } from '@checkfirst/nestjs-outlook';
 
 @Injectable()
 export class YourService {
+  // Handle token save event
+  @OnEvent(OutlookEventTypes.AUTH_TOKENS_SAVE)
+  async handleAuthTokensSave(userId: string, tokenData: TokenResponse) {
+    console.log(`Saving new tokens for user ${userId}`);
+    // Save tokens to your database
+  }
+
+  // Handle calendar events
   @OnEvent(OutlookEventTypes.EVENT_CREATED)
   handleOutlookEventCreated(data: OutlookResourceData) {
     console.log('New Outlook event created:', data.id);
-    // Handle the new event...
+    // Handle the new event
   }
 
   @OnEvent(OutlookEventTypes.EVENT_UPDATED)
   handleOutlookEventUpdated(data: OutlookResourceData) {
     console.log('Outlook event updated:', data.id);
-    // Handle the updated event...
+    // Handle the updated event
   }
 
   @OnEvent(OutlookEventTypes.EVENT_DELETED)
   handleOutlookEventDeleted(data: OutlookResourceData) {
     console.log('Outlook event deleted:', data.id);
-    // Handle the deleted event...
+    // Handle the deleted event
   }
 }
 ```
 
-These events are emitted when Microsoft Graph sends webhook notifications to your application for calendar events changes.
+## Example Application Architecture
+
+For a more complete example of how to structure your application using this library, check out the sample application included in this repository:
+
+**Path:** `samples/nestjs-outlook-example/`
+
+The sample app demonstrates a modular architecture with clear separation of concerns:
+
+```
+src/
+├── auth/
+│   ├── auth.controller.ts   # Handles Microsoft login and OAuth callback
+│   └── auth.module.ts       # Configures MicrosoftOutlookModule for auth
+│
+├── calendar/
+│   ├── calendar.controller.ts # API endpoints for calendar operations
+│   ├── calendar.module.ts     # Configures MicrosoftOutlookModule for calendar
+│   ├── calendar.service.ts    # Your business logic for calendars
+│   └── dto/
+│       └── create-event.dto.ts # Data validation for event creation
+│
+├── email/
+│   ├── email.controller.ts   # API endpoints for email operations
+│   ├── email.module.ts       # Configures MicrosoftOutlookModule for email
+│   ├── email.service.ts      # Your business logic for emails
+│   └── dto/
+│       └── send-email.dto.ts # Data validation for email sending
+│
+└── app.module.ts             # Root module that imports feature modules
+```
+
+> **See:** [`samples/nestjs-outlook-example`](./samples/nestjs-outlook-example) for a full working example.
+
+This modular architecture keeps concerns separated and makes your application easier to maintain and test.
 
 ## Support
 

package/dist/controllers/calendar.controller.d.ts

@@ -0,0 +1,10 @@
+import { Response, Request } from 'express';
+import { CalendarService } from '../services/calendar/calendar.service';
+import { OutlookWebhookNotificationDto } from '../dto/outlook-webhook-notification.dto';
+export declare class CalendarController {
+    private readonly calendarService;
+    private readonly logger;
+    constructor(calendarService: CalendarService);
+    handleCalendarWebhook(validationToken: string, notificationBody: OutlookWebhookNotificationDto, req: Request, res: Response): Promise<void>;
+    private processCalendarNotificationBatch;
+}

package/dist/controllers/calendar.controller.js

@@ -0,0 +1,166 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var CalendarController_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalendarController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const calendar_service_1 = require("../services/calendar/calendar.service");
+const outlook_webhook_notification_dto_1 = require("../dto/outlook-webhook-notification.dto");
+let CalendarController = CalendarController_1 = class CalendarController {
+    constructor(calendarService) {
+        this.calendarService = calendarService;
+        this.logger = new common_1.Logger(CalendarController_1.name);
+    }
+    async handleCalendarWebhook(validationToken, notificationBody, req, res) {
+        if (validationToken) {
+            this.logger.log('Handling Microsoft Graph validation request');
+            const decodedToken = decodeURIComponent(validationToken);
+            res.set('Content-Type', 'text/plain; charset=utf-8');
+            res.send(decodedToken);
+            return;
+        }
+        try {
+            this.logger.debug(`Received webhook notification: ${JSON.stringify(notificationBody)}`);
+            if (Array.isArray(notificationBody.value) && notificationBody.value.length > 2) {
+                this.logger.log(`Received batch of ${notificationBody.value.length.toString()} notifications, responding with 202 Accepted`);
+                res.status(202).json({
+                    success: true,
+                    message: 'Notifications accepted for processing',
+                });
+                this.processCalendarNotificationBatch(notificationBody).catch((error) => {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    this.logger.error(`Error processing notification batch: ${errorMessage}`);
+                });
+                return;
+            }
+            if (Array.isArray(notificationBody.value) && notificationBody.value.length > 0) {
+                const results = await this.processCalendarNotificationBatch(notificationBody);
+                res.json({
+                    success: true,
+                    message: `Processed ${results.successCount.toString()} out of ${notificationBody.value.length.toString()} notifications`,
+                });
+                return;
+            }
+            this.logger.warn('Received webhook notification with unexpected format');
+            res.json({
+                success: true,
+                message: `Received webhook notification with unexpected format`,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const errorStack = error instanceof Error ? error.stack : undefined;
+            this.logger.error(`Error processing webhook notification: ${errorMessage}`, errorStack);
+            res.status(500).json({
+                success: false,
+                message: 'Error processing webhook notification',
+            });
+        }
+    }
+    async processCalendarNotificationBatch(notificationBody) {
+        let successCount = 0;
+        let failureCount = 0;
+        const processedEvents = new Set();
+        for (const item of notificationBody.value) {
+            if (!item.subscriptionId || !item.resource) {
+                this.logger.warn(`Skipping notification with missing required fields`);
+                failureCount++;
+                continue;
+            }
+            const resourceData = item.resourceData;
+            if (resourceData.id && processedEvents.has(resourceData.id)) {
+                this.logger.debug(`Skipping duplicate event: ${resourceData.id}`);
+                continue;
+            }
+            if (resourceData.id) {
+                processedEvents.add(resourceData.id);
+            }
+            const validChangeTypes = ['created', 'updated', 'deleted'];
+            if (!validChangeTypes.includes(item.changeType)) {
+                this.logger.warn(`Skipping notification with unsupported change type: ${item.changeType}`);
+                failureCount++;
+                continue;
+            }
+            try {
+                const changeNotification = {
+                    subscriptionId: item.subscriptionId,
+                    subscriptionExpirationDateTime: item.subscriptionExpirationDateTime,
+                    changeType: item.changeType,
+                    resource: item.resource,
+                    resourceData: resourceData,
+                    clientState: item.clientState,
+                    tenantId: item.tenantId,
+                };
+                const result = await this.calendarService.handleOutlookWebhook(changeNotification);
+                if (result.success) {
+                    this.logger.log(`Successfully processed ${item.changeType} event for resource ID: ${resourceData.id || 'unknown'}`);
+                    successCount++;
+                }
+                else {
+                    this.logger.warn(`Failed to process event: ${result.message}`);
+                    failureCount++;
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                this.logger.error(`Error processing event: ${errorMessage}`);
+                failureCount++;
+            }
+        }
+        this.logger.log(`Finished processing batch: ${successCount.toString()} succeeded, ${failureCount.toString()} failed`);
+        return { successCount, failureCount };
+    }
+};
+exports.CalendarController = CalendarController;
+__decorate([
+    (0, common_1.Post)('webhook'),
+    (0, common_1.HttpCode)(200),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: 'Webhook validation or notification processed successfully',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 202,
+        description: 'Notification accepted for processing',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 500,
+        description: 'Server error processing the notification',
+    }),
+    (0, swagger_1.ApiQuery)({
+        name: 'validationToken',
+        required: false,
+        description: 'Token sent by Microsoft Graph to validate the webhook endpoint',
+    }),
+    (0, swagger_1.ApiBody)({
+        description: 'Microsoft Graph webhook notification payload',
+        type: outlook_webhook_notification_dto_1.OutlookWebhookNotificationDto,
+        required: false,
+    }),
+    __param(0, (0, common_1.Query)('validationToken')),
+    __param(1, (0, common_1.Body)()),
+    __param(2, (0, common_1.Req)()),
+    __param(3, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, outlook_webhook_notification_dto_1.OutlookWebhookNotificationDto, Object, Object]),
+    __metadata("design:returntype", Promise)
+], CalendarController.prototype, "handleCalendarWebhook", null);
+exports.CalendarController = CalendarController = CalendarController_1 = __decorate([
+    (0, swagger_1.ApiTags)('Calendar'),
+    (0, common_1.Controller)('calendar'),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [calendar_service_1.CalendarService])
+], CalendarController);
+//# sourceMappingURL=calendar.controller.js.map

package/dist/controllers/calendar.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.controller.js","sourceRoot":"","sources":["../../src/controllers/calendar.controller.ts"],"names":[],"mappings":"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"}

package/dist/controllers/email.controller.d.ts

@@ -0,0 +1,10 @@
+import { Response, Request } from 'express';
+import { EmailService } from '../services/email/email.service';
+import { OutlookWebhookNotificationDto } from '../dto/outlook-webhook-notification.dto';
+export declare class EmailController {
+    private readonly emailService;
+    private readonly logger;
+    constructor(emailService: EmailService);
+    handleEmailWebhook(validationToken: string, notificationBody: OutlookWebhookNotificationDto, req: Request, res: Response): Promise<void>;
+    private processEmailNotificationBatch;
+}

package/dist/controllers/email.controller.js

@@ -0,0 +1,166 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var EmailController_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const email_service_1 = require("../services/email/email.service");
+const outlook_webhook_notification_dto_1 = require("../dto/outlook-webhook-notification.dto");
+let EmailController = EmailController_1 = class EmailController {
+    constructor(emailService) {
+        this.emailService = emailService;
+        this.logger = new common_1.Logger(EmailController_1.name);
+    }
+    async handleEmailWebhook(validationToken, notificationBody, req, res) {
+        if (validationToken) {
+            this.logger.log('Handling Microsoft Graph validation request');
+            const decodedToken = decodeURIComponent(validationToken);
+            res.set('Content-Type', 'text/plain; charset=utf-8');
+            res.send(decodedToken);
+            return;
+        }
+        try {
+            this.logger.debug(`Received email webhook notification: ${JSON.stringify(notificationBody)}`);
+            if (Array.isArray(notificationBody.value) && notificationBody.value.length > 2) {
+                this.logger.log(`Received batch of ${notificationBody.value.length.toString()} email notifications, responding with 202 Accepted`);
+                res.status(202).json({
+                    success: true,
+                    message: 'Email notifications accepted for processing',
+                });
+                this.processEmailNotificationBatch(notificationBody).catch((error) => {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    this.logger.error(`Error processing email notification batch: ${errorMessage}`);
+                });
+                return;
+            }
+            if (Array.isArray(notificationBody.value) && notificationBody.value.length > 0) {
+                const results = await this.processEmailNotificationBatch(notificationBody);
+                res.json({
+                    success: true,
+                    message: `Processed ${results.successCount.toString()} out of ${notificationBody.value.length.toString()} email notifications`,
+                });
+                return;
+            }
+            this.logger.warn('Received email webhook notification with unexpected format');
+            res.json({
+                success: true,
+                message: `Received email webhook notification with unexpected format`,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const errorStack = error instanceof Error ? error.stack : undefined;
+            this.logger.error(`Error processing email webhook notification: ${errorMessage}`, errorStack);
+            res.status(500).json({
+                success: false,
+                message: 'Error processing email webhook notification',
+            });
+        }
+    }
+    async processEmailNotificationBatch(notificationBody) {
+        let successCount = 0;
+        let failureCount = 0;
+        const processedMessages = new Set();
+        for (const item of notificationBody.value) {
+            if (!item.subscriptionId || !item.resource) {
+                this.logger.warn(`Skipping email notification with missing required fields`);
+                failureCount++;
+                continue;
+            }
+            const resourceData = item.resourceData;
+            if (resourceData.id && processedMessages.has(resourceData.id)) {
+                this.logger.debug(`Skipping duplicate email: ${resourceData.id}`);
+                continue;
+            }
+            if (resourceData.id) {
+                processedMessages.add(resourceData.id);
+            }
+            const validChangeTypes = ['created', 'updated', 'deleted'];
+            if (!validChangeTypes.includes(item.changeType)) {
+                this.logger.warn(`Skipping email notification with unsupported change type: ${item.changeType}`);
+                failureCount++;
+                continue;
+            }
+            try {
+                const changeNotification = {
+                    subscriptionId: item.subscriptionId,
+                    subscriptionExpirationDateTime: item.subscriptionExpirationDateTime,
+                    changeType: item.changeType,
+                    resource: item.resource,
+                    resourceData: resourceData,
+                    clientState: item.clientState,
+                    tenantId: item.tenantId,
+                };
+                const result = await this.emailService.handleEmailWebhook(changeNotification);
+                if (result.success) {
+                    this.logger.log(`Successfully processed ${item.changeType} email for resource ID: ${resourceData.id || 'unknown'}`);
+                    successCount++;
+                }
+                else {
+                    this.logger.warn(`Failed to process email: ${result.message}`);
+                    failureCount++;
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                this.logger.error(`Error processing email event: ${errorMessage}`);
+                failureCount++;
+            }
+        }
+        this.logger.log(`Finished processing email batch: ${successCount.toString()} succeeded, ${failureCount.toString()} failed`);
+        return { successCount, failureCount };
+    }
+};
+exports.EmailController = EmailController;
+__decorate([
+    (0, common_1.Post)('webhook'),
+    (0, common_1.HttpCode)(200),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: 'Webhook validation or notification processed successfully',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 202,
+        description: 'Notification accepted for processing',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 500,
+        description: 'Server error processing the notification',
+    }),
+    (0, swagger_1.ApiQuery)({
+        name: 'validationToken',
+        required: false,
+        description: 'Token sent by Microsoft Graph to validate the webhook endpoint',
+    }),
+    (0, swagger_1.ApiBody)({
+        description: 'Microsoft Graph webhook notification payload',
+        type: outlook_webhook_notification_dto_1.OutlookWebhookNotificationDto,
+        required: false,
+    }),
+    __param(0, (0, common_1.Query)('validationToken')),
+    __param(1, (0, common_1.Body)()),
+    __param(2, (0, common_1.Req)()),
+    __param(3, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, outlook_webhook_notification_dto_1.OutlookWebhookNotificationDto, Object, Object]),
+    __metadata("design:returntype", Promise)
+], EmailController.prototype, "handleEmailWebhook", null);
+exports.EmailController = EmailController = EmailController_1 = __decorate([
+    (0, swagger_1.ApiTags)('Email'),
+    (0, common_1.Controller)('email'),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [email_service_1.EmailService])
+], EmailController);
+//# sourceMappingURL=email.controller.js.map

package/dist/controllers/email.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.controller.js","sourceRoot":"","sources":["../../src/controllers/email.controller.ts"],"names":[],"mappings":"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"}

package/dist/controllers/microsoft-auth.controller.d.ts

@@ -1,7 +1,8 @@
 import { Response } from 'express';
-import { MicrosoftAuthService } from '../services/microsoft-auth.service';
+import { MicrosoftAuthService } from '../services/auth/microsoft-auth.service';
 export declare class MicrosoftAuthController {
     private readonly microsoftAuthService;
+    private readonly logger;
     constructor(microsoftAuthService: MicrosoftAuthService);
-    callback(code: string, state: string, res: Response): Promise<Response<any, Record<string, any>>>;
+    handleOauthCallback(code: string, state: string, res: Response): Promise<Response<any, Record<string, any>>>;
 }