n8n-nodes-outlook-subscription 0.1.0

package/README.md

@@ -0,0 +1,102 @@
+# n8n-nodes-outlook-subscription
+
+n8n community nodes for Microsoft Outlook mail automation and change notifications via Microsoft Graph.
+
+## Nodes
+
+### Outlook Subscription (action node)
+
+Manage Microsoft Graph subscriptions and perform full Outlook mail operations.
+
+**Subscription** resource:
+
+| Operation | Description |
+|---|---|
+| Create | Create one or more subscriptions, with duplicate detection |
+| Delete | Delete a subscription by ID |
+| List | List all active subscriptions |
+| Renew | Extend a subscription's expiry |
+
+**Message** resource:
+
+| Operation | Description |
+|---|---|
+| Delete | Soft-delete a message (moves to Deleted Items) |
+| Get | Fetch a message with optional `$select` / `$expand` |
+| List | Query messages with filter, ordering, field selection, and auto-pagination |
+| Move | Move a message to a folder — pick from list, enter an ID, or create a new folder |
+| Reply | Reply to a message (HTML or plain text) |
+| Reply All | Reply-all to a message (HTML or plain text) |
+| Send | Send a new email with optional CC, BCC, and a binary attachment |
+| Update | Set flag status, single-value extended properties, or any arbitrary PATCH fields |
+
+**Attachment** resource:
+
+| Operation | Description |
+|---|---|
+| Download | Download an attachment as binary data |
+| List | List all attachments on a message |
+
+**User** resource:
+
+| Operation | Description |
+|---|---|
+| Get | Fetch a user profile by ID or UPN |
+
+---
+
+### Outlook Subscription Notification Trigger
+
+Receives Microsoft Graph change notifications via webhook.
+
+- Automatically handles Graph validation token handshakes.
+- Resolves the full message for `message` notifications (configurable).
+- Applies client-side message filters (subject, sender, custom fields).
+- Opportunistically renews the subscription on delivery.
+- Supports lifecycle notification URL for managed renewal.
+
+---
+
+### Outlook Subscription Lifecycle Trigger
+
+Receives Microsoft Graph lifecycle notifications (e.g. `subscriptionRemoved`, `reauthorizationRequired`) and surfaces them as n8n items for downstream handling.
+
+---
+
+## Credentials
+
+Use the **Microsoft Outlook Subscription OAuth2 API** credential (OAuth 2.0, delegated).
+
+Required Microsoft Graph scopes:
+
+| Scope | Required for |
+|---|---|
+| `openid` | Authentication |
+| `offline_access` | Token refresh |
+| `Mail.Read` | Read messages, subscriptions |
+| `Mail.ReadWrite` | Update, delete, move, send, reply |
+| `MailboxSettings.Read` | Folder operations |
+| `User.Read.All` | User Get operation |
+
+To access a shared mailbox or another user's mailbox, the signed-in account must have the necessary Exchange Online delegate permissions.
+
+---
+
+## Node Architecture
+
+| Use case | Node to use |
+|---|---|
+| n8n receives mail notifications in-workflow | `Outlook Subscription Notification Trigger` |
+| An external service receives notifications | `Outlook Subscription` (create operation, supply your own URL) |
+| Perform mail operations (send, move, list…) | `Outlook Subscription` |
+| Handle subscription lifecycle events | `Outlook Subscription Lifecycle Trigger` |
+
+---
+
+## Notes
+
+- Subscription lifetime is clamped to Microsoft Graph limits (45 min – 7 days).
+- Duplicate subscriptions are detected and skipped automatically during Create.
+- Message List supports full OData `$filter`, ordering, field selection, and auto-pagination via `@odata.nextLink`.
+- Move to new folder: selecting "Create New Folder" creates the folder then moves the message atomically in two Graph calls.
+- Send with attachment: enable **Add Attachment** and supply the binary field name from an upstream node.

package/dist/credentials/MicrosoftOutlookSubscriptionOAuth2Api.credentials.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicrosoftOutlookSubscriptionOAuth2Api = void 0;
+const scopes = [
+    "openid",
+    "offline_access",
+    "Mail.Read",
+    "Mail.ReadWrite",
+    "MailboxSettings.Read",
+    "User.Read.All",
+];
+class MicrosoftOutlookSubscriptionOAuth2Api {
+    constructor() {
+        this.name = "microsoftOutlookSubscriptionOAuth2Api";
+        this.extends = ["microsoftOAuth2Api"];
+        this.displayName = "Microsoft Outlook Subscription OAuth2 API";
+        this.documentationUrl = "microsoft";
+        this.properties = [
+            {
+                displayName: "Scope",
+                name: "scope",
+                type: "hidden",
+                default: scopes.join(" "),
+            },
+        ];
+    }
+}
+exports.MicrosoftOutlookSubscriptionOAuth2Api = MicrosoftOutlookSubscriptionOAuth2Api;
+//# sourceMappingURL=MicrosoftOutlookSubscriptionOAuth2Api.credentials.js.map

package/dist/credentials/MicrosoftOutlookSubscriptionOAuth2Api.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MicrosoftOutlookSubscriptionOAuth2Api.credentials.js","sourceRoot":"","sources":["../../credentials/MicrosoftOutlookSubscriptionOAuth2Api.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAM,MAAM,GAAG;IACb,QAAQ;IACR,gBAAgB;IAChB,WAAW;IACX,gBAAgB;IAChB,sBAAsB;IACtB,eAAe;CAChB,CAAC;AAEF,MAAa,qCAAqC;IAAlD;QACE,SAAI,GAAG,uCAAuC,CAAC;QAE/C,YAAO,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAEjC,gBAAW,GAAG,2CAA2C,CAAC;QAE1D,qBAAgB,GAAG,WAAW,CAAC;QAE/B,eAAU,GAAsB;YAC9B;gBACE,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;aAC1B;SACF,CAAC;IACJ,CAAC;CAAA;AAjBD,sFAiBC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./credentials/MicrosoftOutlookSubscriptionOAuth2Api.credentials"), exports);
+__exportStar(require("./nodes/OutlookSubscription/OutlookSubscription.node"), exports);
+__exportStar(require("./nodes/OutlookSubscriptionNotificationTrigger/OutlookSubscriptionNotificationTrigger.node"), exports);
+__exportStar(require("./nodes/OutlookSubscriptionLifecycleTrigger/OutlookSubscriptionLifecycleTrigger.node"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kGAAgF;AAChF,uFAAqE;AACrE,6HAA2G;AAC3G,uHAAqG"}