@joshuanode/n8n-nodes-cipp 0.0.10 → 0.0.13

package/README.md

@@ -19,9 +19,9 @@ This node provides full integration with the CIPP API, enabling automation of:
 - **Identity Management** - Users, groups, MFA, devices
 - **Tenant Administration** - Alerts, licenses, standards
 - **Intune** - Applications, Autopilot, device actions
-- **Teams & SharePoint** - Teams, sites, voice numbers
+- **Teams & SharePoint** - Teams, sites, voice numbers, shifts scheduling
 - **Security & Compliance** - Defender alerts, incidents
-- **Tools** - Breach search, Graph API requests
+- **Tools** - Breach search, Graph API requests, ExecGraphRequest
 - **CIPP System** - Scheduled jobs, backups
 
 ### User-Friendly Design
@@ -66,17 +66,18 @@ For detailed authentication setup, see the [CIPP API Documentation](https://docs
 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **Tenant**         | Get Many, Get Licenses, Get CSP Licenses, CSP License Action, Clear Cache                                                                                     |
 | **User**           | Get Many, Add, Disable, Enable, Reset Password, Reset MFA, Revoke Sessions, Remove, Create TAP, Set Per-User MFA, Send MFA Push, Clear Immutable ID, Offboard |
-| **Group**          | Add, Edit Members, Delete, Hide from GAL, Set Delivery Management, Get Many                                                                         |
-| **Device**         | Get Many, Manage, Execute Action, Get Recovery Key, Get LAPS Password                                                                               |
-| **Autopilot**      | Get Many, Assign, Remove, Sync, Get Configurations                                                                                                  |
-| **Mailbox**        | Convert, Enable Archive, Set Out of Office, Set Email Forwarding                                                                                    |
-| **Alert**          | Add, Get Many, Get Security Alerts, Get Security Incidents, Set Alert Status, Set Incident Status                                                   |
-| **Application**    | Get Many, Assign, Remove, Add WinGet/Store/Chocolatey/MSP/Office Apps                                                                               |
-| **Team**           | Add, Get Many, Get Sites, Get Activity, Manage Site Members/Permissions                                                                             |
-| **Voice**          | Get Phone Numbers, Get Locations, Assign/Unassign Numbers                                                                                           |
-| **Scheduled Item** | Add, Get Many, Remove                                                                                                                               |
-| **Backup**         | Get Many, Run, Restore, Set Auto-Backup                                                                                                             |
-| **Tools**          | Breach Search (Account/Tenant), Graph Request (List), Graph Request (Exec)                                                                       |
+| **Group**          | Add, Edit Members, Delete, Hide from GAL, Set Delivery Management, Get Many                                                                                   |
+| **Device**         | Get Many, Manage, Execute Action, Get Recovery Key, Get LAPS Password                                                                                         |
+| **Autopilot**      | Get Many, Assign, Remove, Sync, Get Configurations                                                                                                            |
+| **Mailbox**        | Convert, Enable Archive, Set Out of Office, Set Email Forwarding                                                                                              |
+| **Alert**          | Add, Get Many, Get Security Alerts, Get Security Incidents, Set Alert Status, Set Incident Status                                                             |
+| **Application**    | Get Many, Assign, Remove, Add WinGet/Store/Chocolatey/MSP/Office Apps                                                                                         |
+| **Team**           | Add, Get Many, Get Sites, Get Activity, Manage Site Members/Permissions                                                                                       |
+| **Teams Shift**    | List/Create/Update/Delete Shifts, Open Shifts, Scheduling Groups, Time Off Reasons; List/Create/Approve/Decline Time Off, Swap Shift & Offer Shift Requests   |
+| **Voice**          | Get Phone Numbers, Get Locations, Assign/Unassign Numbers                                                                                                     |
+| **Scheduled Item** | Add, Get Many, Remove                                                                                                                                         |
+| **Backup**         | Get Many, Run, Restore, Set Auto-Backup                                                                                                                       |
+| **Tools**          | Breach Search (Account/Tenant), Exec Graph Request, Graph Request (List), Graph Request (Exec)                                                                |
 
 ## Example Usage
 
@@ -130,7 +131,34 @@ $select: id,displayName,userPrincipalName
 $filter: startsWith(displayName,'John')
 ```
 
-### Teams Shifts Graph Exec Request (POST/PATCH/GET)
+### Teams Shifts (Dedicated Resource)
+
+```
+Resource: Teams Shift
+Operation: List Shifts
+Tenant: Select from dropdown
+Team ID: <team-guid>
+Filters → Start Date: 2024-03-01T00:00:00Z
+Filters → End Date: 2024-03-31T23:59:59Z
+```
+
+```
+Resource: Teams Shift
+Operation: Create Shift
+Tenant: Select from dropdown
+Team ID: <team-guid>
+User ID: <aad-user-id>
+Start Date Time: 2024-03-15T08:00:00Z
+End Date Time: 2024-03-15T16:00:00Z
+Options → Display Name: Morning Shift
+Options → Theme: blue
+```
+
+> ⚠️ **CIPP-API Requirement**: The Teams Shift resource and the Exec Graph Request tool both use `POST /api/ExecGraphRequest`, which is **not part of the standard CIPP API**. You must be running a custom fork of [CIPP-API](https://github.com/KelvinTegelaar/CIPP-API) that exposes the `ExecGraphRequest` endpoint. Without this, all Teams Shift operations and the Exec Graph Request tool will return a 404 or 400 error.
+>
+> If your fork uses a different route name (e.g., `/api/GraphRequest`), the `Graph Request (Exec)` tool has a built-in fallback. The dedicated Teams Shift resource does not — it expects `/api/ExecGraphRequest` to exist.
+
+### Graph Request (Exec) — Raw Graph Calls
 
 ```
 Resource: Tools
@@ -142,6 +170,7 @@ Body: {"userId":"<aad-user-id>","schedulingGroupId":"<group-id>","sharedShift":{
 ```
 
 Notes:
+
 - `Graph Request (Exec)` sends a `POST` to `/api/ExecGraphRequest` and falls back to `/api/GraphRequest` if your fork uses that route name.
 - By default, client-side validation requires endpoints matching `teams/{id}/schedule/*` (can be disabled in `Exec Options`).
 

package/dist/nodes/Cipp/Cipp.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cipp.node.d.ts","sourceRoot":"","sources":["../../../nodes/Cipp/Cipp.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,qBAAqB,EACrB,wBAAwB,EAExB,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAWtB,qBAAa,IAAK,YAAW,SAAS;IACrC,WAAW,EAAE,oBAAoB,CA4H/B;IAEF,OAAO;;wCAGE,wBAAwB,cAClB,qBAAqB,GAC/B,OAAO,CAAC,yBAAyB,CAAC;;;+BAyD9B,qBAAqB,WAClB,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC;;MAqBjC;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAyzDvE"}
+{"version":3,"file":"Cipp.node.d.ts","sourceRoot":"","sources":["../../../nodes/Cipp/Cipp.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,qBAAqB,EACrB,wBAAwB,EAExB,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAWtB,qBAAa,IAAK,YAAW,SAAS;IACrC,WAAW,EAAE,oBAAoB,CAiI/B;IAEF,OAAO;;wCAGE,wBAAwB,cAClB,qBAAqB,GAC/B,OAAO,CAAC,yBAAyB,CAAC;;;+BAyD9B,qBAAqB,WAClB,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC;;MAqBjC;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAymEvE"}

package/dist/nodes/Cipp/Cipp.node.js

@@ -102,6 +102,11 @@ class Cipp {
                         value: 'team',
                         description: 'Manage Teams and SharePoint',
                     },
+                    {
+                        name: 'Teams Shift',
+                        value: 'teamsShift',
+                        description: 'Manage Teams Shifts schedule — shifts, open shifts, groups, time off',
+                    },
                     {
                         name: 'Tenant',
                         value: 'tenant',
@@ -1201,7 +1206,8 @@ class Cipp {
                     }
                     else if (operation === 'execGraphRequest') {
                         const tenantFilter = getTenantFilter();
-                        const endpoint = this.getNodeParameter('execEndpoint', i);
+                        const rawEndpoint = this.getNodeParameter('execEndpoint', i);
+                        const endpoint = normalizeGraphEndpoint(rawEndpoint);
                         const method = this.getNodeParameter('execMethod', i);
                         const payload = { tenantFilter, endpoint, method };
                         if (method === 'POST' || method === 'PATCH') {
@@ -1264,6 +1270,249 @@ class Cipp {
                         }
                     }
                 }
+                // ==================== TEAMS SHIFT ====================
+                else if (resource === 'teamsShift') {
+                    const tenantFilter = getTenantFilter();
+                    const teamId = this.getNodeParameter('teamId', i);
+                    const basePath = `teams/${teamId}/schedule`;
+                    const graphExec = async (method, endpoint, body) => {
+                        const payload = { tenantFilter, endpoint, method };
+                        if (body && Object.keys(body).length > 0) {
+                            payload.body = body;
+                        }
+                        return GenericFunctions_1.cippApiRequest.call(this, 'POST', '/api/ExecGraphRequest', payload, {});
+                    };
+                    const buildFilteredEndpoint = (base) => {
+                        const filters = this.getNodeParameter('listFilters', i, {});
+                        // Raw OData filter takes priority
+                        if (filters.rawFilter) {
+                            return `${base}?$filter=${encodeURIComponent(filters.rawFilter)}`;
+                        }
+                        // Build from convenience date fields
+                        const parts = [];
+                        if (filters.startDate) {
+                            const d = new Date(filters.startDate).toISOString();
+                            parts.push(`sharedShift/startDateTime ge ${d}`);
+                        }
+                        if (filters.endDate) {
+                            const d = new Date(filters.endDate).toISOString();
+                            parts.push(`sharedShift/endDateTime le ${d}`);
+                        }
+                        if (parts.length > 0) {
+                            return `${base}?$filter=${encodeURIComponent(parts.join(' and '))}`;
+                        }
+                        return base;
+                    };
+                    // ── Shifts ──
+                    if (operation === 'listShifts') {
+                        responseData = await graphExec('GET', buildFilteredEndpoint(`${basePath}/shifts`));
+                    }
+                    else if (operation === 'createShift') {
+                        const userId = this.getNodeParameter('userId', i);
+                        const startDateTime = this.getNodeParameter('startDateTime', i);
+                        const endDateTime = this.getNodeParameter('endDateTime', i);
+                        const options = this.getNodeParameter('shiftOptions', i, {});
+                        const sharedShift = {
+                            startDateTime,
+                            endDateTime,
+                        };
+                        if (options.displayName)
+                            sharedShift.displayName = options.displayName;
+                        if (options.notes)
+                            sharedShift.notes = options.notes;
+                        if (options.theme)
+                            sharedShift.theme = options.theme;
+                        if (options.activities) {
+                            sharedShift.activities = JSON.parse(options.activities);
+                        }
+                        responseData = await graphExec('POST', `${basePath}/shifts`, {
+                            userId,
+                            sharedShift,
+                        });
+                    }
+                    else if (operation === 'updateShift') {
+                        const shiftId = this.getNodeParameter('shiftId', i);
+                        const shiftData = parseJsonObjectPayload(this.getNodeParameter('shiftUpdateData', i), 'Shift Data', i);
+                        responseData = await graphExec('PUT', `${basePath}/shifts/${shiftId}`, shiftData);
+                    }
+                    else if (operation === 'deleteShift') {
+                        const shiftId = this.getNodeParameter('shiftId', i);
+                        responseData = await graphExec('DELETE', `${basePath}/shifts/${shiftId}`);
+                    }
+                    // ── Open Shifts ──
+                    else if (operation === 'listOpenShifts') {
+                        responseData = await graphExec('GET', buildFilteredEndpoint(`${basePath}/openShifts`));
+                    }
+                    else if (operation === 'createOpenShift') {
+                        const schedulingGroupId = this.getNodeParameter('schedulingGroupId', i);
+                        const startDateTime = this.getNodeParameter('openShiftStart', i);
+                        const endDateTime = this.getNodeParameter('openShiftEnd', i);
+                        const openSlotCount = this.getNodeParameter('openSlotCount', i);
+                        const options = this.getNodeParameter('openShiftOptions', i, {});
+                        const sharedOpenShift = {
+                            startDateTime,
+                            endDateTime,
+                            openSlotCount,
+                        };
+                        if (options.displayName)
+                            sharedOpenShift.displayName = options.displayName;
+                        if (options.notes)
+                            sharedOpenShift.notes = options.notes;
+                        if (options.theme)
+                            sharedOpenShift.theme = options.theme;
+                        if (options.activities) {
+                            sharedOpenShift.activities = JSON.parse(options.activities);
+                        }
+                        responseData = await graphExec('POST', `${basePath}/openShifts`, {
+                            schedulingGroupId,
+                            sharedOpenShift,
+                        });
+                    }
+                    else if (operation === 'updateOpenShift') {
+                        const openShiftId = this.getNodeParameter('openShiftId', i);
+                        const data = parseJsonObjectPayload(this.getNodeParameter('openShiftUpdateData', i), 'Open Shift Data', i);
+                        responseData = await graphExec('PUT', `${basePath}/openShifts/${openShiftId}`, data);
+                    }
+                    else if (operation === 'deleteOpenShift') {
+                        const openShiftId = this.getNodeParameter('openShiftId', i);
+                        responseData = await graphExec('DELETE', `${basePath}/openShifts/${openShiftId}`);
+                    }
+                    // ── Scheduling Groups ──
+                    else if (operation === 'listSchedulingGroups') {
+                        responseData = await graphExec('GET', buildFilteredEndpoint(`${basePath}/schedulingGroups`));
+                    }
+                    else if (operation === 'createSchedulingGroup') {
+                        const displayName = this.getNodeParameter('groupDisplayName', i);
+                        const userIds = this.getNodeParameter('groupUserIds', i)
+                            .split(',')
+                            .map((id) => id.trim())
+                            .filter((id) => id);
+                        responseData = await graphExec('POST', `${basePath}/schedulingGroups`, {
+                            displayName,
+                            userIds,
+                            isActive: true,
+                        });
+                    }
+                    else if (operation === 'updateSchedulingGroup') {
+                        const groupId = this.getNodeParameter('schedulingGroupUpdateId', i);
+                        const data = parseJsonObjectPayload(this.getNodeParameter('schedulingGroupUpdateData', i), 'Scheduling Group Data', i);
+                        responseData = await graphExec('PUT', `${basePath}/schedulingGroups/${groupId}`, data);
+                    }
+                    else if (operation === 'deleteSchedulingGroup') {
+                        const groupId = this.getNodeParameter('schedulingGroupUpdateId', i);
+                        responseData = await graphExec('PUT', `${basePath}/schedulingGroups/${groupId}`, { isActive: false });
+                    }
+                    // ── Time Off Reasons ──
+                    else if (operation === 'listTimeOffReasons') {
+                        responseData = await graphExec('GET', buildFilteredEndpoint(`${basePath}/timeOffReasons`));
+                    }
+                    else if (operation === 'createTimeOffReason') {
+                        const displayName = this.getNodeParameter('reasonDisplayName', i);
+                        const iconType = this.getNodeParameter('iconType', i);
+                        responseData = await graphExec('POST', `${basePath}/timeOffReasons`, {
+                            displayName,
+                            iconType,
+                            isActive: true,
+                        });
+                    }
+                    else if (operation === 'updateTimeOffReason') {
+                        const reasonId = this.getNodeParameter('timeOffReasonId', i);
+                        const data = parseJsonObjectPayload(this.getNodeParameter('timeOffReasonUpdateData', i), 'Time Off Reason Data', i);
+                        responseData = await graphExec('PUT', `${basePath}/timeOffReasons/${reasonId}`, data);
+                    }
+                    else if (operation === 'deleteTimeOffReason') {
+                        const reasonId = this.getNodeParameter('timeOffReasonId', i);
+                        responseData = await graphExec('PUT', `${basePath}/timeOffReasons/${reasonId}`, { isActive: false });
+                    }
+                    // ── Time Off Requests ──
+                    else if (operation === 'listTimeOffRequests') {
+                        responseData = await graphExec('GET', buildFilteredEndpoint(`${basePath}/timeOffRequests`));
+                    }
+                    else if (operation === 'createTimeOffRequest') {
+                        const startDateTime = this.getNodeParameter('timeOffStart', i);
+                        const endDateTime = this.getNodeParameter('timeOffEnd', i);
+                        const timeOffReasonId = this.getNodeParameter('timeOffReasonIdForRequest', i);
+                        responseData = await graphExec('POST', `${basePath}/timeOffRequests`, {
+                            startDateTime,
+                            endDateTime,
+                            timeOffReasonId,
+                        });
+                    }
+                    else if (operation === 'approveTimeOffRequest') {
+                        const requestId = this.getNodeParameter('timeOffRequestId', i);
+                        const message = this.getNodeParameter('approvalMessage', i, '');
+                        const body = {};
+                        if (message)
+                            body.message = message;
+                        responseData = await graphExec('POST', `${basePath}/timeOffRequests/${requestId}/approve`, body);
+                    }
+                    else if (operation === 'declineTimeOffRequest') {
+                        const requestId = this.getNodeParameter('timeOffRequestId', i);
+                        const message = this.getNodeParameter('approvalMessage', i, '');
+                        const body = {};
+                        if (message)
+                            body.message = message;
+                        responseData = await graphExec('POST', `${basePath}/timeOffRequests/${requestId}/decline`, body);
+                    }
+                    // ── Swap Shift Requests ──
+                    else if (operation === 'listSwapShiftRequests') {
+                        responseData = await graphExec('GET', buildFilteredEndpoint(`${basePath}/swapShiftsChangeRequests`));
+                    }
+                    else if (operation === 'createSwapShiftRequest') {
+                        const senderShiftId = this.getNodeParameter('senderShiftId', i);
+                        const recipientShiftId = this.getNodeParameter('recipientShiftId', i);
+                        const recipientUserId = this.getNodeParameter('swapRecipientUserId', i);
+                        responseData = await graphExec('POST', `${basePath}/swapShiftsChangeRequests`, {
+                            senderShiftId,
+                            recipientShiftId,
+                            recipientUserId,
+                        });
+                    }
+                    else if (operation === 'approveSwapShiftRequest') {
+                        const requestId = this.getNodeParameter('swapShiftRequestId', i);
+                        const message = this.getNodeParameter('approvalMessage', i, '');
+                        const body = {};
+                        if (message)
+                            body.message = message;
+                        responseData = await graphExec('POST', `${basePath}/swapShiftsChangeRequests/${requestId}/approve`, body);
+                    }
+                    else if (operation === 'declineSwapShiftRequest') {
+                        const requestId = this.getNodeParameter('swapShiftRequestId', i);
+                        const message = this.getNodeParameter('approvalMessage', i, '');
+                        const body = {};
+                        if (message)
+                            body.message = message;
+                        responseData = await graphExec('POST', `${basePath}/swapShiftsChangeRequests/${requestId}/decline`, body);
+                    }
+                    // ── Offer Shift Requests ──
+                    else if (operation === 'listOfferShiftRequests') {
+                        responseData = await graphExec('GET', buildFilteredEndpoint(`${basePath}/offerShiftRequests`));
+                    }
+                    else if (operation === 'createOfferShiftRequest') {
+                        const senderShiftId = this.getNodeParameter('offerSenderShiftId', i);
+                        const recipientUserId = this.getNodeParameter('offerRecipientUserId', i);
+                        responseData = await graphExec('POST', `${basePath}/offerShiftRequests`, {
+                            senderShiftId,
+                            recipientUserId,
+                        });
+                    }
+                    else if (operation === 'approveOfferShiftRequest') {
+                        const requestId = this.getNodeParameter('offerShiftRequestId', i);
+                        const message = this.getNodeParameter('approvalMessage', i, '');
+                        const body = {};
+                        if (message)
+                            body.message = message;
+                        responseData = await graphExec('POST', `${basePath}/offerShiftRequests/${requestId}/approve`, body);
+                    }
+                    else if (operation === 'declineOfferShiftRequest') {
+                        const requestId = this.getNodeParameter('offerShiftRequestId', i);
+                        const message = this.getNodeParameter('approvalMessage', i, '');
+                        const body = {};
+                        if (message)
+                            body.message = message;
+                        responseData = await graphExec('POST', `${basePath}/offerShiftRequests/${requestId}/decline`, body);
+                    }
+                }
                 // ==================== IDENTITY ====================
                 else if (resource === 'identity') {
                     const tenantFilter = getTenantFilter();