@checkfirst/nestjs-outlook 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 CheckFirst Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -0,0 +1,224 @@
+# NestJS Outlook
+
+<p align="center">
+  <a href="https://checkfirst.ai" target="_blank">
+    <img src="https://raw.githubusercontent.com/checkfirst-ltd/nestjs-outlook/main/assets/checkfirst-logo.png" width="400" alt="CheckFirst Logo" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@checkfirst/nestjs-outlook"><img src="https://img.shields.io/npm/v/@checkfirst/nestjs-outlook.svg" alt="NPM Version" /></a>
+  <a href="https://www.npmjs.com/package/@checkfirst/nestjs-outlook"><img src="https://img.shields.io/npm/dm/@checkfirst/nestjs-outlook.svg" alt="NPM Downloads" /></a>
+  <a href="https://github.com/checkfirst-ltd/nestjs-outlook/blob/main/LICENSE"><img src="https://img.shields.io/github/license/checkfirst-ltd/nestjs-outlook" alt="License" /></a>
+</p>
+
+An opinionated NestJS module for Microsoft Outlook integration that provides easy access to Microsoft Graph API for emails, calendars, and more.
+
+## Features
+
+- 🔄 Simplified Microsoft OAuth flow
+- 📅 Calendar events management
+- 🔔 Real-time webhooks for changes
+- 🔐 Secure token storage and refresh
+
+## Installation
+
+```bash
+npm install @checkfirst/nestjs-outlook
+```
+
+## Setup
+
+### 1. Database Setup
+
+This library requires two database tables in your application's database. Create these tables using a migration:
+
+```typescript
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+export class CreateOutlookTables1697025846000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    // Create outlook_webhook_subscriptions table
+    await queryRunner.query(`
+      CREATE TABLE outlook_webhook_subscriptions (
+        id INTEGER PRIMARY KEY GENERATED ALWAYS AS IDENTITY,
+        subscription_id VARCHAR(255) NOT NULL,
+        user_id INTEGER NOT NULL,
+        resource VARCHAR(255) NOT NULL,
+        change_type VARCHAR(255) NOT NULL,
+        client_state VARCHAR(255) NOT NULL,
+        notification_url VARCHAR(255) NOT NULL,
+        expiration_date_time TIMESTAMP NOT NULL,
+        is_active BOOLEAN DEFAULT true,
+        access_token TEXT,
+        refresh_token TEXT,
+        created_at TIMESTAMP DEFAULT NOW() NOT NULL,
+        updated_at TIMESTAMP DEFAULT NOW() NOT NULL
+      );
+    `);
+
+    // Create microsoft_csrf_tokens table
+    await queryRunner.query(`
+      CREATE TABLE microsoft_csrf_tokens (
+        id INTEGER PRIMARY KEY GENERATED ALWAYS AS IDENTITY,
+        token VARCHAR(64) NOT NULL,
+        user_id VARCHAR(255) NOT NULL,
+        expires TIMESTAMP NOT NULL,
+        created_at TIMESTAMP DEFAULT NOW() NOT NULL,
+        CONSTRAINT "UQ_microsoft_csrf_tokens_token" UNIQUE (token)
+      );
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`DROP TABLE IF EXISTS outlook_webhook_subscriptions`);
+    await queryRunner.query(`DROP TABLE IF EXISTS microsoft_csrf_tokens`);
+  }
+}
+```
+
+You can customize this migration to match your database dialect (PostgreSQL, MySQL, etc.) if needed.
+
+### 2. Import Required Modules
+
+Register the module in your NestJS application and include the module entities in TypeORM:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { EventEmitterModule } from '@nestjs/event-emitter';
+import { ScheduleModule } from '@nestjs/schedule';
+import { MicrosoftOutlookModule } from '@checkfirst/nestjs-outlook';
+import * as path from 'path';
+
+// Resolve the path to the outlook package
+const outlookPackagePath = path.dirname(require.resolve('@checkfirst/nestjs-outlook/package.json'));
+
+@Module({
+  imports: [
+    // Required modules
+    TypeOrmModule.forRoot({
+      // Your TypeORM configuration
+      entities: [
+        // Your app entities
+        __dirname + '/**/*.entity{.ts,.js}',
+        // Include outlook module entities
+        path.join(outlookPackagePath, 'dist', 'entities', '*.entity.js')
+      ],
+    }),
+    ScheduleModule.forRoot(),
+    EventEmitterModule.forRoot(),
+    
+    // Microsoft Outlook Module
+    MicrosoftOutlookModule.forRoot({
+      clientId: 'YOUR_MICROSOFT_APP_CLIENT_ID',
+      clientSecret: 'YOUR_MICROSOFT_APP_CLIENT_SECRET',
+      redirectPath: 'auth/microsoft/callback',
+      backendBaseUrl: 'https://your-api.example.com',
+      basePath: 'api/v1',
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### 3. Create a Login Controller
+
+Create a controller to handle Microsoft authentication:
+
+```typescript
+export class CalendarController {
+  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 the login URL from the Microsoft auth service
+    return await this.microsoftAuthService.getLoginUrl(user.id.toString());
+  }
+}
+```
+
+## Available Services
+
+- `OutlookService` - Main service for Microsoft Graph API operations on Outlook
+- `MicrosoftAuthService` - For authentication and token management
+
+## Events
+
+The library uses NestJS's EventEmitter to emit events for various Outlook activities. You can listen to these events in your application to react to changes.
+
+### Available Events
+
+The library exposes event types through the `OutlookEventTypes` enum:
+
+- `OutlookEventTypes.AUTH_TOKENS_SAVE` - Emitted when OAuth tokens are initially saved
+- `OutlookEventTypes.AUTH_TOKENS_UPDATE` - Emitted when OAuth tokens are refreshed
+- `OutlookEventTypes.EVENT_CREATED` - Emitted when a new Outlook calendar event is created via webhook
+- `OutlookEventTypes.EVENT_UPDATED` - Emitted when an Outlook calendar event is updated via webhook
+- `OutlookEventTypes.EVENT_DELETED` - Emitted when an Outlook calendar event is deleted via webhook
+
+### Listening to Events
+
+You can listen to these events in your application using the `@OnEvent` decorator from `@nestjs/event-emitter` and the `OutlookEventTypes` enum:
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { OnEvent } from '@nestjs/event-emitter';
+import { OutlookEventTypes, OutlookResourceData } from '@checkfirst/nestjs-outlook';
+
+@Injectable()
+export class YourService {
+  @OnEvent(OutlookEventTypes.EVENT_CREATED)
+  handleOutlookEventCreated(data: OutlookResourceData) {
+    console.log('New Outlook event created:', data.id);
+    // Handle the new event...
+  }
+
+  @OnEvent(OutlookEventTypes.EVENT_UPDATED)
+  handleOutlookEventUpdated(data: OutlookResourceData) {
+    console.log('Outlook event updated:', data.id);
+    // Handle the updated event...
+  }
+
+  @OnEvent(OutlookEventTypes.EVENT_DELETED)
+  handleOutlookEventDeleted(data: OutlookResourceData) {
+    console.log('Outlook event deleted:', data.id);
+    // Handle the deleted event...
+  }
+}
+```
+
+These events are emitted when Microsoft Graph sends webhook notifications to your application for calendar events changes.
+
+## Support
+
+- [GitHub Issues](https://github.com/checkfirst-ltd/nestjs-outlook/issues)
+- [Documentation](https://github.com/checkfirst-ltd/nestjs-outlook#readme)
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for more details.
+
+## Code of Conduct
+
+This project adheres to a Code of Conduct that all participants are expected to follow. Please read the [Code of Conduct](https://github.com/checkfirst-ltd/nestjs-outlook/blob/main/CONTRIBUTING.md#code-of-conduct) for details on our expectations.
+
+## About CheckFirst
+
+<a href="https://checkfirst.ai" target="_blank">
+  <img src="https://raw.githubusercontent.com/checkfirst-ltd/nestjs-outlook/main/assets/checkfirst-banner.png" alt="CheckFirst Banner" width="100%" />
+</a>
+
+[CheckFirst](https://checkfirst.ai) is a trusted provider of developer tools and solutions. We build open-source libraries that help developers create better applications faster.
+
+## License
+
+[MIT](LICENSE) © [CheckFirst Ltd](https://checkfirst.ai) 

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const MICROSOFT_CONFIG = "MICROSOFT_CONFIG";

package/dist/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MICROSOFT_CONFIG = void 0;
+exports.MICROSOFT_CONFIG = 'MICROSOFT_CONFIG';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AACa,QAAA,gBAAgB,GAAG,kBAAkB,CAAC"}

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

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

package/dist/controllers/microsoft-auth.controller.js

@@ -0,0 +1,101 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicrosoftAuthController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const microsoft_auth_service_1 = require("../services/microsoft-auth.service");
+let MicrosoftAuthController = class MicrosoftAuthController {
+    constructor(microsoftAuthService) {
+        this.microsoftAuthService = microsoftAuthService;
+    }
+    async callback(code, state, res) {
+        if (!code) {
+            throw new common_1.BadRequestException('No code provided');
+        }
+        if (!state) {
+            throw new common_1.BadRequestException('No state parameter provided');
+        }
+        try {
+            await this.microsoftAuthService.exchangeCodeForToken(code, state);
+            return res.status(common_1.HttpStatus.OK).send(`
+        <h1>Authorization successful!</h1>
+        <p>Your Microsoft account has been linked successfully.</p>
+        <p>You can close this tab now.</p>
+        <script>
+          // Optionally notify the parent window
+          if (window.opener) {
+            window.opener.postMessage('microsoft-auth-success', '*');
+          }
+        </script>
+      `);
+        }
+        catch (error) {
+            console.error('Authentication failed:', error);
+            throw new common_1.InternalServerErrorException('Authentication failed. Please try again.');
+        }
+    }
+};
+exports.MicrosoftAuthController = MicrosoftAuthController;
+__decorate([
+    (0, common_1.Get)('callback'),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Microsoft OAuth callback handler',
+        description: 'Processes the callback from Microsoft OAuth authentication flow. Exchanges the authorization code for access and refresh tokens, saves them for the user, and sets up necessary webhooks for calendar synchronization. The user ID is extracted from the state parameter.',
+    }),
+    (0, swagger_1.ApiQuery)({
+        name: 'code',
+        description: 'Authorization code from Microsoft',
+        required: true,
+        type: String,
+        example: 'M.R3_BAY.c0def4c2-12bf-0b29-9a3a-f8a1c4f56789',
+    }),
+    (0, swagger_1.ApiQuery)({
+        name: 'state',
+        description: 'Base64 encoded state containing user ID and CSRF token',
+        required: true,
+        type: String,
+        example: 'eyJ1c2VySWQiOiI3IiwiY3NyZiI6IjEyMzQ1In0',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: 'Authentication successful, tokens saved and webhooks created',
+        content: {
+            'text/html': {
+                example: '<h1>Authorization successful!</h1><p>Your Microsoft account has been linked successfully.</p>',
+            },
+        },
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 400,
+        description: 'Invalid or missing code/state parameters',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 500,
+        description: 'Server error during authentication process',
+    }),
+    (0, swagger_1.ApiProduces)('text/html'),
+    __param(0, (0, common_1.Query)('code')),
+    __param(1, (0, common_1.Query)('state')),
+    __param(2, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, Object]),
+    __metadata("design:returntype", Promise)
+], MicrosoftAuthController.prototype, "callback", null);
+exports.MicrosoftAuthController = MicrosoftAuthController = __decorate([
+    (0, swagger_1.ApiTags)('Microsoft Auth'),
+    (0, common_1.Controller)('auth/microsoft'),
+    __metadata("design:paramtypes", [microsoft_auth_service_1.MicrosoftAuthService])
+], MicrosoftAuthController);
+//# sourceMappingURL=microsoft-auth.controller.js.map

package/dist/controllers/microsoft-auth.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"microsoft-auth.controller.js","sourceRoot":"","sources":["../../src/controllers/microsoft-auth.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAQwB;AAExB,6CAA4F;AAC5F,+EAA0E;AAInE,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAClC,YAA6B,oBAA0C;QAA1C,yBAAoB,GAApB,oBAAoB,CAAsB;IAAG,CAAC;IA4DrE,AAAN,KAAK,CAAC,QAAQ,CAAgB,IAAY,EAAkB,KAAa,EAAS,GAAa;QAC7F,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,4BAAmB,CAAC,kBAAkB,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,4BAAmB,CAAC,6BAA6B,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAGlE,OAAO,GAAG,CAAC,MAAM,CAAC,mBAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;;;;;;;;;;OAUrC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;YAC/C,MAAM,IAAI,qCAA4B,CAAC,0CAA0C,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;CACF,CAAA;AA1FY,0DAAuB;AA6D5B;IAvCL,IAAA,YAAG,EAAC,UAAU,CAAC;IACf,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EACT,2QAA2Q;KAC9Q,CAAC;IACD,IAAA,kBAAQ,EAAC;QACR,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mCAAmC;QAChD,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,+CAA+C;KACzD,CAAC;IACD,IAAA,kBAAQ,EAAC;QACR,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,yCAAyC;KACnD,CAAC;IACD,IAAA,qBAAW,EAAC;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,8DAA8D;QAC3E,OAAO,EAAE;YACP,WAAW,EAAE;gBACX,OAAO,EACL,+FAA+F;aAClG;SACF;KACF,CAAC;IACD,IAAA,qBAAW,EAAC;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,0CAA0C;KACxD,CAAC;IACD,IAAA,qBAAW,EAAC;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,4CAA4C;KAC1D,CAAC;IACD,IAAA,qBAAW,EAAC,WAAW,CAAC;IACT,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IAAgB,WAAA,IAAA,cAAK,EAAC,OAAO,CAAC,CAAA;IAAiB,WAAA,IAAA,YAAG,GAAE,CAAA;;;;uDA4BhF;kCAzFU,uBAAuB;IAFnC,IAAA,iBAAO,EAAC,gBAAgB,CAAC;IACzB,IAAA,mBAAU,EAAC,gBAAgB,CAAC;qCAEwB,6CAAoB;GAD5D,uBAAuB,CA0FnC"}

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

@@ -0,0 +1,8 @@
+import { Response, Request } from 'express';
+import { OutlookService } from '../services/outlook.service';
+import { OutlookWebhookNotificationDto } from '../dto/outlook-webhook-notification.dto';
+export declare class OutlookController {
+    private readonly outlookService;
+    constructor(outlookService: OutlookService);
+    handleOutlookWebhook(validationToken: string, notificationBody: OutlookWebhookNotificationDto, req: Request, res: Response): Promise<void>;
+}

package/dist/controllers/outlook.controller.js

@@ -0,0 +1,117 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutlookController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const outlook_service_1 = require("../services/outlook.service");
+const outlook_webhook_notification_dto_1 = require("../dto/outlook-webhook-notification.dto");
+let OutlookController = class OutlookController {
+    constructor(outlookService) {
+        this.outlookService = outlookService;
+    }
+    async handleOutlookWebhook(validationToken, notificationBody, req, res) {
+        if (validationToken) {
+            console.log('Handling Microsoft Graph validation request with token:', validationToken);
+            const decodedToken = decodeURIComponent(validationToken);
+            res.set('Content-Type', 'text/plain; charset=utf-8');
+            res.send(decodedToken);
+            return;
+        }
+        try {
+            console.log('Received webhook notification:', JSON.stringify(notificationBody));
+            if (Array.isArray(notificationBody.value)) {
+                const processedEvents = new Set();
+                let hasSuccessfullyProcessed = false;
+                for (const item of notificationBody.value) {
+                    const resourceData = item.resourceData;
+                    if (resourceData.id && processedEvents.has(resourceData.id)) {
+                        continue;
+                    }
+                    if (resourceData.id) {
+                        processedEvents.add(resourceData.id);
+                    }
+                    if (resourceData.id && ['deleted', 'created', 'updated'].includes(item.changeType)) {
+                        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.outlookService.handleOutlookWebhook(changeNotification);
+                            console.log(`Processed ${item.changeType} event for ${resourceData.id}: ${JSON.stringify(result)}`);
+                            hasSuccessfullyProcessed = true;
+                        }
+                        catch (error) {
+                            console.error(`Error processing ${item.changeType} event ${resourceData.id}:`, error);
+                        }
+                    }
+                    else {
+                        console.log(`Skipping notification of type: ${item.changeType}`);
+                    }
+                }
+                res.json({
+                    success: true,
+                    message: hasSuccessfullyProcessed
+                        ? `Successfully processed events`
+                        : `Received notifications, but no events were processed`,
+                });
+                return;
+            }
+            res.json({
+                success: true,
+                message: `Received webhook notification in unexpected format`,
+            });
+        }
+        catch (error) {
+            console.error('Error processing webhook notification:', error);
+            res.status(500).json({
+                success: false,
+                message: 'Error processing webhook notification',
+            });
+        }
+    }
+};
+exports.OutlookController = OutlookController;
+__decorate([
+    (0, common_1.Post)('webhook'),
+    (0, common_1.HttpCode)(200),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: 'Webhook notification processed successfully',
+    }),
+    (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)
+], OutlookController.prototype, "handleOutlookWebhook", null);
+exports.OutlookController = OutlookController = __decorate([
+    (0, swagger_1.ApiTags)('Outlook'),
+    (0, common_1.Controller)('outlook'),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [outlook_service_1.OutlookService])
+], OutlookController);
+//# sourceMappingURL=outlook.controller.js.map

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

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

package/dist/dto/outlook-webhook-notification.dto.d.ts

@@ -0,0 +1,19 @@
+export declare class OutlookResourceData {
+    '@odata.type'?: string;
+    '@odata.id'?: string;
+    '@odata.etag'?: string;
+    id: string;
+    [key: string]: unknown;
+}
+export declare class OutlookWebhookNotificationItemDto {
+    subscriptionId: string;
+    subscriptionExpirationDateTime: string;
+    changeType: string;
+    resource: string;
+    resourceData: OutlookResourceData;
+    clientState?: string;
+    tenantId?: string;
+}
+export declare class OutlookWebhookNotificationDto {
+    value: OutlookWebhookNotificationItemDto[];
+}