@blickwerk/n8n-nodes-microsoft-planner 1.4.0 → 1.5.5

package/dist/credentials/MicrosoftPlannerOAuth2Api.credentials.js

@@ -6,6 +6,7 @@ class MicrosoftPlannerOAuth2Api {
         this.name = 'microsoftPlannerOAuth2Api';
         this.extends = ['oAuth2Api'];
         this.displayName = 'Microsoft Planner OAuth2 API';
+        // eslint-disable-next-line n8n-nodes-base/cred-class-field-documentation-url-miscased
         this.documentationUrl = 'https://docs.microsoft.com/en-us/graph/auth-v2-user';
         this.properties = [
             {
@@ -17,14 +18,14 @@ class MicrosoftPlannerOAuth2Api {
             {
                 displayName: 'Authorization URL',
                 name: 'authUrl',
-                type: 'hidden',
+                type: 'string',
                 default: 'https://login.microsoftonline.com/common/oauth2/v2.0/authorize',
                 required: true,
             },
             {
                 displayName: 'Access Token URL',
                 name: 'accessTokenUrl',
-                type: 'hidden',
+                type: 'string',
                 default: 'https://login.microsoftonline.com/common/oauth2/v2.0/token',
                 required: true,
             },

package/dist/nodes/MicrosoftPlanner/BucketDescription.d.ts

@@ -0,0 +1,3 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const bucketOperations: INodeProperties[];
+export declare const bucketFields: INodeProperties[];

package/dist/nodes/MicrosoftPlanner/BucketDescription.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bucketFields = exports.bucketOperations = void 0;
+// ----------------------------------
+//         Bucket operations
+// ----------------------------------
+exports.bucketOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['bucket'],
+            },
+        },
+        options: [
+            {
+                name: 'Create',
+                value: 'create',
+                description: 'Create a new bucket in a plan',
+                action: 'Create a bucket',
+            },
+            {
+                name: 'Get',
+                value: 'get',
+                description: 'Get a bucket',
+                action: 'Get a bucket',
+            },
+            {
+                name: 'Get Many',
+                value: 'getAll',
+                description: 'Get many buckets in a plan',
+                action: 'Get many buckets',
+            },
+            {
+                name: 'Update',
+                value: 'update',
+                description: 'Update a bucket',
+                action: 'Update a bucket',
+            },
+            {
+                name: 'Delete',
+                value: 'delete',
+                description: 'Delete a bucket',
+                action: 'Delete a bucket',
+            },
+        ],
+        default: 'getAll',
+    },
+];
+// ----------------------------------
+//         Bucket fields
+// ----------------------------------
+exports.bucketFields = [
+    // ----------------------------------
+    //         bucket:create
+    // ----------------------------------
+    {
+        displayName: 'Plan ID',
+        name: 'planId',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['bucket'],
+                operation: ['create', 'getAll'],
+            },
+        },
+        default: '',
+        description: 'The ID of the plan this bucket belongs to',
+    },
+    // ----------------------------------
+    //         bucket:getAll
+    // ----------------------------------
+    // No Return All / Limit options; Graph does not support $top/$limit for Planner.
+    {
+        displayName: 'Name',
+        name: 'name',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['bucket'],
+                operation: ['create'],
+            },
+        },
+        default: '',
+        description: 'Name of the bucket',
+    },
+    {
+        displayName: 'Upsert',
+        name: 'upsert',
+        type: 'boolean',
+        default: false,
+        displayOptions: {
+            show: {
+                resource: ['bucket'],
+                operation: ['create'],
+            },
+        },
+        description: 'Whether to return the existing bucket if one with the same name already exists in the plan',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['bucket'],
+                operation: ['getAll'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Select Properties',
+                name: 'select',
+                type: 'string',
+                default: '',
+                description: 'Comma-separated list of properties to specify which fields to return (e.g. id,name)',
+            },
+        ],
+    },
+    // ----------------------------------
+    //         bucket:get / bucket:update / bucket:delete
+    // ----------------------------------
+    {
+        displayName: 'Bucket ID',
+        name: 'bucketId',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['bucket'],
+                operation: ['get', 'update', 'delete'],
+            },
+        },
+        default: '',
+        description: 'The ID of the bucket',
+    },
+    {
+        displayName: 'Update Fields',
+        name: 'updateFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['bucket'],
+                operation: ['update'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Name',
+                name: 'name',
+                type: 'string',
+                default: '',
+                description: 'Name of the bucket',
+            },
+            {
+                displayName: 'Order Hint',
+                name: 'orderHint',
+                type: 'string',
+                default: '',
+                description: 'Used to sort buckets in the plan',
+            },
+        ],
+    },
+];

package/dist/nodes/MicrosoftPlanner/CommentDescription.d.ts

@@ -0,0 +1,3 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const commentOperations: INodeProperties[];
+export declare const commentFields: INodeProperties[];

package/dist/nodes/MicrosoftPlanner/CommentDescription.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commentFields = exports.commentOperations = void 0;
+// ----------------------------------
+//         Comment operations
+// ----------------------------------
+exports.commentOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['comment'],
+            },
+        },
+        options: [
+            {
+                name: 'Create',
+                value: 'create',
+                description: 'Create a new comment on a task',
+                action: 'Create a comment',
+            },
+            {
+                name: 'Get Many',
+                value: 'getAll',
+                description: 'Get all comments from a task',
+                action: 'Get many comments',
+            },
+        ],
+        default: 'create',
+    },
+];
+// ----------------------------------
+//         Comment fields
+// ----------------------------------
+exports.commentFields = [
+    // ----------------------------------
+    //         comment:create
+    // ----------------------------------
+    {
+        displayName: 'Task',
+        name: 'taskId',
+        type: 'resourceLocator',
+        default: { mode: 'id', value: '' },
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['comment'],
+                operation: ['create'],
+            },
+        },
+        modes: [
+            {
+                displayName: 'By ID',
+                name: 'id',
+                type: 'string',
+                placeholder: 'e.g. rz1EH6N_a0aLpRm-2QifxZgAF5OL',
+            },
+        ],
+        description: 'The task to comment on',
+    },
+    {
+        displayName: 'Content',
+        name: 'content',
+        type: 'string',
+        typeOptions: {
+            rows: 5,
+        },
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['comment'],
+                operation: ['create'],
+            },
+        },
+        default: '',
+        description: 'The content of the comment',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['comment'],
+                operation: ['create'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Content Type',
+                name: 'contentType',
+                type: 'options',
+                options: [
+                    {
+                        name: 'HTML',
+                        value: 'html',
+                    },
+                    {
+                        name: 'Text',
+                        value: 'text',
+                    },
+                ],
+                default: 'text',
+                description: 'The format of the comment content',
+            },
+        ],
+    },
+    // ----------------------------------
+    //         comment:getAll
+    // ----------------------------------
+    {
+        displayName: 'Task',
+        name: 'taskId',
+        type: 'resourceLocator',
+        default: { mode: 'id', value: '' },
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['comment'],
+                operation: ['getAll'],
+            },
+        },
+        modes: [
+            {
+                displayName: 'By ID',
+                name: 'id',
+                type: 'string',
+                placeholder: 'e.g. rz1EH6N_a0aLpRm-2QifxZgAF5OL',
+            },
+        ],
+        description: 'The task to get comments from',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['comment'],
+                operation: ['getAll'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Select Properties',
+                name: 'select',
+                type: 'string',
+                default: '',
+                description: 'Comma-separated list of properties to specify which fields to return (e.g. id,content)',
+            },
+        ],
+    },
+];

package/dist/nodes/MicrosoftPlanner/GenericFunctions.d.ts

@@ -3,6 +3,22 @@ export declare function microsoftApiRequest(this: IHookFunctions | IExecuteFunct
 export declare function microsoftApiRequestAllItems(this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions, propertyName: string, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, query?: IDataObject): Promise<any>;
 export declare function cleanETag(eTag: string): string;
 export declare function formatDateTime(dateTime: string | undefined): string | undefined;
-export declare function getUserIdByEmail(this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions, email: string): Promise<string | null>;
-export declare function parseAssignments(assignmentsString: string): string[];
+export declare function getUserIdByEmail(this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions, email: string): Promise<string>;
+export declare function parseAssignments(assignments: string | string[]): string[];
 export declare function createAssignmentsObject(userIds: string[]): IDataObject;
+/**
+ * Encodes a URL for use as a key in plannerExternalReferences.
+ * OData requires keys in open types to be free of certain special characters like '.',
+ * which must be encoded.
+ */
+export declare function encodeReferenceKey(url: string): string;
+/**
+ * Generates a GUID/UUID v4.
+ * Useful for creating new ID keys for checklist items.
+ */
+export declare function generateGuid(): string;
+/**
+ * Formats comment content for Microsoft Graph API conversation posts.
+ * Wraps plain text in HTML paragraph tags if needed.
+ */
+export declare function formatCommentContent(content: string, contentType?: string): IDataObject;

package/dist/nodes/MicrosoftPlanner/GenericFunctions.js

@@ -7,6 +7,9 @@ exports.formatDateTime = formatDateTime;
 exports.getUserIdByEmail = getUserIdByEmail;
 exports.parseAssignments = parseAssignments;
 exports.createAssignmentsObject = createAssignmentsObject;
+exports.encodeReferenceKey = encodeReferenceKey;
+exports.generateGuid = generateGuid;
+exports.formatCommentContent = formatCommentContent;
 const n8n_workflow_1 = require("n8n-workflow");
 async function microsoftApiRequest(method, resource, body = {}, qs = {}, uri, headers = {}) {
     const options = {
@@ -26,7 +29,7 @@ async function microsoftApiRequest(method, resource, body = {}, qs = {}, uri, he
         if (Object.keys(body).length === 0) {
             delete options.body;
         }
-        return await this.helpers.requestOAuth2.call(this, 'microsoftPlannerOAuth2Api', options);
+        return await this.helpers.httpRequestWithAuthentication.call(this, 'microsoftPlannerOAuth2Api', options);
     }
     catch (error) {
         throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
@@ -37,7 +40,8 @@ async function microsoftApiRequestAllItems(propertyName, method, endpoint, body
     let responseData;
     let uri;
     do {
-        responseData = await microsoftApiRequest.call(this, method, endpoint, body, query, uri);
+        const activeQuery = uri ? {} : query;
+        responseData = await microsoftApiRequest.call(this, method, endpoint, body, activeQuery, uri);
         uri = responseData['@odata.nextLink'];
         returnData.push.apply(returnData, responseData[propertyName]);
     } while (responseData['@odata.nextLink'] !== undefined);
@@ -65,21 +69,37 @@ function formatDateTime(dateTime) {
     return date.toISOString();
 }
 async function getUserIdByEmail(email) {
+    // 1. Check if it's already a UUID
+    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(email)) {
+        return email;
+    }
     try {
-        const response = await microsoftApiRequest.call(this, 'GET', `/users/${encodeURIComponent(email)}`);
+        // 2. Try direct lookup (fastest)
+        const response = await microsoftApiRequest.call(this, 'GET', `/users/${encodeURIComponent(email)}`, {}, { $select: 'id' });
         return response.id;
     }
     catch (error) {
-        // Log error for debugging
-        console.error(`Failed to get user ID for email ${email}:`, error.message || error);
-        return null;
+        // 3. Try filter lookup (handling UPN mismatch or restricted visibility)
+        try {
+            const users = await microsoftApiRequestAllItems.call(this, 'value', 'GET', '/users', {}, { $filter: `mail eq '${email}' or userPrincipalName eq '${email}'`, $select: 'id' });
+            if (users && users.length > 0) {
+                return users[0].id;
+            }
+        }
+        catch (filterError) {
+            // Ignore filter error, throw original or new error
+        }
+        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Could not find user with email/ID: ${email}`);
     }
 }
-function parseAssignments(assignmentsString) {
-    if (!assignmentsString || assignmentsString.trim() === '') {
+function parseAssignments(assignments) {
+    if (Array.isArray(assignments)) {
+        return assignments;
+    }
+    if (!assignments || assignments.trim() === '') {
         return [];
     }
-    return assignmentsString
+    return assignments
         .split(',')
         .map((email) => email.trim())
         .filter((email) => email.length > 0);
@@ -94,3 +114,48 @@ function createAssignmentsObject(userIds) {
     }
     return assignments;
 }
+/**
+ * Encodes a URL for use as a key in plannerExternalReferences.
+ * OData requires keys in open types to be free of certain special characters like '.',
+ * which must be encoded.
+ */
+function encodeReferenceKey(url) {
+    // Use encodeURI to handle spaces and % but preserve URI structure (/, ?, &, =)
+    let encoded = encodeURI(url);
+    // Manually replace OData forbidden characters that encodeURI preserves
+    // Forbidden: . : % @ #
+    // encodeURI handles % (encodes to %25 unless it's a valid escape sequence)
+    encoded = encoded
+        .replace(/\./g, '%2E')
+        .replace(/:/g, '%3A')
+        .replace(/@/g, '%40')
+        .replace(/#/g, '%23');
+    return encoded;
+}
+/**
+ * Generates a GUID/UUID v4.
+ * Useful for creating new ID keys for checklist items.
+ */
+function generateGuid() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Formats comment content for Microsoft Graph API conversation posts.
+ * Wraps plain text in HTML paragraph tags if needed.
+ */
+function formatCommentContent(content, contentType = 'text') {
+    // When we wrap text in HTML tags, we need to set contentType to 'html'
+    // Otherwise the tags will be displayed as literal text in Planner
+    const isHtml = contentType === 'html';
+    const formattedContent = isHtml ? content : `<p>${content}</p>`;
+    return {
+        body: {
+            contentType: 'html', // Always use 'html' since we're wrapping in tags
+            content: formattedContent,
+        },
+    };
+}

package/dist/nodes/MicrosoftPlanner/MicrosoftPlanner.node.d.ts

@@ -9,6 +9,9 @@ export declare class MicrosoftPlanner implements INodeType {
             getTasks(this: ILoadOptionsFunctions): Promise<{
                 results: any;
             }>;
+            getGroups(this: ILoadOptionsFunctions): Promise<{
+                results: any;
+            }>;
         };
     };
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;