@mspcopilot/n8n-nodes-connectwise 0.2.4 → 0.3.1

package/dist-community/credentials/ConnectWisePsaApi.credentials.js

@@ -117,9 +117,18 @@ class ConnectWisePsaApi {
     name: "checkForUpdates",
     type: "boolean",
     default: !0,
-    hint: "Current version: 0.2.4 (community edition)",
+    hint: "Current version: 0.3.1 (community edition)",
     description: "Check for new versions of this node package and show notifications when updates are available"
-  } ];
+  }, ...process.env.MSPCOPILOT_BETA === "true" ? [ {
+    displayName: "Access Key",
+    name: "accessKey",
+    type: "string",
+    typeOptions: {
+      password: !0
+    },
+    default: "",
+    hint: "To enable beta or server-side features"
+  } ] : [] ];
   async authenticate(credentials, requestOptions) {
     const serverUrl = credentials.site === "custom" ? credentials.customServer : credentials.site, base64Auth = Buffer.from(`${credentials.companyId}+${credentials.publicKey}:${credentials.privateKey}`).toString("base64");
     return requestOptions.baseURL || (requestOptions.baseURL = `https://${serverUrl}`), 

package/dist-community/nodes/ConnectWise/PSA/ConnectWisePsa.node.js

@@ -74,7 +74,7 @@ const resources = {
 
 class ConnectWisePsa {
   constructor() {
-    console.log(`🔌 ConnectWise PSA Node Loaded | 📦 v0.2.4 | 🏗️  Build: ${"community".toUpperCase()} (${"prod".toUpperCase()} mode)`);
+    console.log(`🔌 ConnectWise PSA Node Loaded | 📦 v0.3.1 | 🏗️  Build: ${"community".toUpperCase()} (${"prod".toUpperCase()} mode)`);
   }
   description={
     displayName: "ConnectWise PSA",

package/dist-community/nodes/ConnectWise/PSA/ConnectWisePsaTrigger.node.js

@@ -0,0 +1,506 @@
+var __defProp = Object.defineProperty;
+
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+
+var __getOwnPropNames = Object.getOwnPropertyNames;
+
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: !0
+  });
+}, __copyProps = (to, from, except, desc) => {
+  if (from && typeof from == "object" || typeof from == "function") for (let key of __getOwnPropNames(from)) !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, {
+    get: () => from[key],
+    enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+  });
+  return to;
+};
+
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: !0
+}), mod);
+
+var ConnectWisePsaTrigger_node_exports = {};
+
+__export(ConnectWisePsaTrigger_node_exports, {
+  ConnectWisePsaTrigger: () => ConnectWisePsaTrigger
+});
+
+module.exports = __toCommonJS(ConnectWisePsaTrigger_node_exports);
+
+var import_n8n_workflow = require("n8n-workflow"), import_methods = require("./methods"), import_client = require("./transport/client"), import_common = require("./descriptions/common.descriptions");
+
+const WEBHOOK_REGISTRY_URL = "https://api.mspcopilot.io/watchtower/api/n8n/triggers";
+
+function toWatchtowerQuery(query) {
+  const keyMap = {
+    boardIds: "board.id",
+    statusIds: "status.id",
+    companyIds: "company.id",
+    priorityIds: "priority.id",
+    typeIds: "type.id",
+    subtypeIds: "subtype.id",
+    itemIds: "item.id",
+    sourceIds: "source.id"
+  }, result = {};
+  for (const [key, value] of Object.entries(query)) {
+    const mappedKey = keyMap[key] ?? key;
+    result[mappedKey] = value;
+  }
+  return result;
+}
+
+function formatWebhookError(error) {
+  const e = error, status = e.response?.status, serverMessage = e.response?.data?.message;
+  return serverMessage ? status ? `[${status}] ${serverMessage}` : serverMessage : status === 401 ? "[401] Authentication failed. Check your Access Key in credentials." : status === 403 ? "[403] Access denied. Check that your Access Key is valid and the Watchtower service is reachable." : status === 502 || status === 503 || status === 504 ? `[${status}] Watchtower service is temporarily unavailable. Try again in a moment.` : status ? `[${status}] ${e.message ?? "Request failed"}` : e.message ?? "Unknown error";
+}
+
+async function notifyWebhookAction(context, options) {
+  const {action: action, webhookUrl: webhookUrl, webhookId: webhookId, type: type, query: query, options: triggerOptions, isTest: isTest, metadata: metadata} = options, credentials = await context.getCredentials("connectWisePsaApi"), companyId = credentials.companyId, accessKey = credentials.accessKey;
+  if (!accessKey) throw new Error("An Access Key is required to use this trigger. Get one at https://link.mspcopilot.io/settings?tab=support, then edit this node's ConnectWise PSA credentials in n8n and paste it into the Access Key field.");
+  await context.helpers.httpRequest({
+    method: "POST",
+    url: WEBHOOK_REGISTRY_URL,
+    headers: {
+      "X-Company-Id": companyId,
+      Authorization: `Bearer ${accessKey}`
+    },
+    body: {
+      action: action,
+      webhookId: webhookId,
+      webhookUrl: webhookUrl,
+      type: type,
+      query: action === "delete" ? void 0 : query ? toWatchtowerQuery(query) : void 0,
+      options: action === "delete" ? void 0 : triggerOptions,
+      isTest: isTest,
+      metadata: {
+        workflowId: metadata?.workflowId,
+        workflowName: metadata?.workflowName
+      }
+    },
+    json: !0
+  });
+}
+
+function getFilterParameters(context) {
+  const getParam = (name, defaultValue) => {
+    try {
+      return context.getNodeParameter(name, defaultValue);
+    } catch {
+      return defaultValue;
+    }
+  }, resource = getParam("resource", "ticket"), query = {}, boardIds = getParam("boardIds", []);
+  boardIds.length > 0 && (query.boardIds = boardIds);
+  const statusIds = getParam("statusIds", []);
+  statusIds.length > 0 && (query.statusIds = statusIds);
+  const priorityIds = getParam("priorityIds", []);
+  priorityIds.length > 0 && (query.priorityIds = priorityIds);
+  const sourceIds = getParam("sourceIds", []);
+  sourceIds.length > 0 && (query.sourceIds = sourceIds);
+  const options = {}, timingConditions = getParam("timingConditions", {});
+  timingConditions.minTicketAge && (options.minTicketAge = timingConditions.minTicketAge), 
+  timingConditions.minTimeInStatus && (options.minTimeInStatus = timingConditions.minTimeInStatus);
+  const triggerOn = getParam("triggerOn", [ "enter" ]);
+  if (options.onEnter = triggerOn.includes("enter"), options.onExit = triggerOn.includes("exit"), 
+  options.onCreate = triggerOn.includes("create"), options.onUpdate = triggerOn.includes("update"), 
+  options.onDelete = triggerOn.includes("delete"), triggerOn.includes("repeat")) {
+    const repeatEvery = getParam("repeatEvery", "");
+    if (!repeatEvery) throw new import_n8n_workflow.NodeOperationError(context.getNode(), "Repeat Every is required when Repeat lifecycle event is selected");
+    options.repeatEvery = repeatEvery;
+    const maxRepeats = getParam("maxRepeats", "");
+    options.maxRepeats = maxRepeats !== "" && Number(maxRepeats) > 0 ? Number(maxRepeats) : 0;
+  }
+  const skipExistingMatches = getParam("skipExistingMatches", !0);
+  options.skipExistingMatches = skipExistingMatches;
+  const rearm = getParam("rearm", "never");
+  if (options.rearm = rearm, rearm === "cooldown") {
+    const cooldown = getParam("cooldown", "");
+    if (!cooldown) throw new import_n8n_workflow.NodeOperationError(context.getNode(), "Cooldown Duration is required when rearm is set to Notify After Cooldown");
+    options.cooldown = cooldown;
+  }
+  return {
+    resource: resource,
+    query: query,
+    options: options
+  };
+}
+
+class ConnectWisePsaTrigger {
+  description={
+    hidden: process.env.MSPCOPILOT_BETA !== "true",
+    displayName: "ConnectWise PSA Trigger",
+    name: "connectWisePsaTrigger",
+    icon: {
+      light: "file:connectwise-light.svg",
+      dark: "file:connectwise-dark.svg"
+    },
+    group: [ "trigger" ],
+    version: 1,
+    subtitle: '={{{"ticket": "Ticket"}[$parameter["resource"]]}}',
+    description: "Trigger on ConnectWise PSA events",
+    defaults: {
+      name: "ConnectWise PSA Trigger"
+    },
+    inputs: [],
+    outputs: [ "main" ],
+    credentials: [ {
+      name: "connectWisePsaApi",
+      required: !0
+    } ],
+    webhooks: [ {
+      name: "default",
+      httpMethod: "POST",
+      responseMode: "onReceived",
+      path: "webhook"
+    } ],
+    properties: [ {
+      displayName: `Powered by Watchtower — see the <a href="https://${import_common.DOCURL_PREFIX}/ticket-trigger${import_common.DOCURL_SUFFIX}" target="_blank">Ticket Trigger Guide</a> for setup and details.`,
+      name: "triggerNotice",
+      type: "notice",
+      default: ""
+    }, {
+      displayName: "Trigger On",
+      name: "resource",
+      type: "options",
+      noDataExpression: !0,
+      options: [ {
+        name: "Ticket",
+        value: "ticket",
+        description: "Trigger on service ticket events"
+      } ],
+      default: "ticket"
+    }, {
+      displayName: "Lifecycle Events",
+      name: "triggerOn",
+      type: "multiOptions",
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ]
+        }
+      },
+      options: [ {
+        name: "Enter",
+        value: "enter",
+        description: "When a ticket first matches conditions"
+      }, {
+        name: "Repeat",
+        value: "repeat",
+        description: "Periodically while a ticket continues matching conditions"
+      }, {
+        name: "Exit",
+        value: "exit",
+        description: "When a ticket stops matching conditions"
+      }, {
+        name: "Create",
+        value: "create",
+        description: "When a ticket is first created and matches conditions"
+      }, {
+        name: "Update",
+        value: "update",
+        description: "Immediately when a matching ticket is updated in ConnectWise"
+      }, {
+        name: "Delete",
+        value: "delete",
+        description: "Immediately when a matching ticket is deleted from ConnectWise"
+      } ],
+      default: [ "enter" ],
+      description: "Which lifecycle events should fire the trigger"
+    }, {
+      displayName: "Ticket Type",
+      name: "ticketType",
+      type: "options",
+      options: [ {
+        name: "Service Ticket",
+        value: "service"
+      } ],
+      default: "service",
+      description: "Type of ticket to monitor"
+    }, {
+      displayName: "Board Names or IDs",
+      name: "boardIds",
+      type: "multiOptions",
+      typeOptions: {
+        loadOptionsMethod: "loadOptions_service_boards",
+        loadOptionsDependsOn: [ "ticketType" ]
+      },
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ]
+        }
+      },
+      default: [],
+      description: 'Filter by boards. Leave empty for all boards. Choose from the list, or specify IDs using an <a href="https://docs.n8n.io/code/expressions/" target="_blank">expression</a>.'
+    }, {
+      displayName: "Status Names or IDs",
+      name: "statusIds",
+      type: "multiOptions",
+      typeOptions: {
+        loadOptionsMethod: "loadOptions_service_statuses_all",
+        loadOptionsDependsOn: [ "boardIds" ]
+      },
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ]
+        }
+      },
+      default: [],
+      description: 'Filter by statuses (select boards first to filter). Choose from the list, or specify IDs using an <a href="https://docs.n8n.io/code/expressions/" target="_blank">expression</a>.'
+    }, {
+      displayName: "Priority Names or IDs",
+      name: "priorityIds",
+      type: "multiOptions",
+      typeOptions: {
+        loadOptionsMethod: "loadOptions_service_priorities"
+      },
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ]
+        }
+      },
+      default: [],
+      description: 'Filter by priorities. Leave empty for all priorities. Choose from the list, or specify IDs using an <a href="https://docs.n8n.io/code/expressions/" target="_blank">expression</a>.'
+    }, {
+      displayName: "Source Names or IDs",
+      name: "sourceIds",
+      type: "multiOptions",
+      typeOptions: {
+        loadOptionsMethod: "loadOptions_service_sources"
+      },
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ]
+        }
+      },
+      default: [],
+      description: 'Filter by ticket sources. Leave empty for all sources. Choose from the list, or specify IDs using an <a href="https://docs.n8n.io/code/expressions/" target="_blank">expression</a>.'
+    }, {
+      displayName: "Timing Conditions",
+      name: "timingConditions",
+      type: "collection",
+      placeholder: "Add Condition",
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ]
+        }
+      },
+      default: {},
+      options: [ {
+        displayName: "Minimum Ticket Age",
+        name: "minTicketAge",
+        type: "string",
+        default: "",
+        placeholder: "15m, 2h, 3d",
+        description: "Only trigger for tickets older than this duration"
+      }, {
+        displayName: "Minimum Time in Current Status",
+        name: "minTimeInStatus",
+        type: "string",
+        default: "",
+        placeholder: "30m, 1h, 1d",
+        description: "Only trigger for tickets in current status longer than this"
+      } ]
+    }, {
+      displayName: "Repeat Every",
+      name: "repeatEvery",
+      type: "string",
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ],
+          triggerOn: [ "repeat" ]
+        }
+      },
+      default: "15m",
+      placeholder: "15m, 1h, 2d",
+      description: "How often to send repeat notifications"
+    }, {
+      displayName: "Maximum Repeats",
+      name: "maxRepeats",
+      type: "number",
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ],
+          triggerOn: [ "repeat" ]
+        }
+      },
+      typeOptions: {
+        minValue: 1
+      },
+      default: "",
+      placeholder: "Unlimited",
+      description: "Maximum repeat notifications per ticket. Leave blank for unlimited."
+    }, {
+      displayName: "If Ticket Re-Enters",
+      name: "rearm",
+      type: "options",
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ]
+        }
+      },
+      options: [ {
+        name: "Never Notify Again",
+        value: "never",
+        description: "Once triggered, will not trigger again even if it re-enters"
+      }, {
+        name: "Notify Immediately",
+        value: "immediate",
+        description: "Trigger again immediately when ticket re-enters"
+      }, {
+        name: "Notify After Cooldown",
+        value: "cooldown",
+        description: "Wait for cooldown period before allowing re-trigger"
+      } ],
+      default: "never",
+      description: "Only applies to Enter events. What happens if a ticket exits and later re-enters conditions.",
+      hint: "This setting controls re-entry behavior for Enter events only"
+    }, {
+      displayName: "Cooldown Duration",
+      name: "cooldown",
+      type: "string",
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ],
+          rearm: [ "cooldown" ]
+        }
+      },
+      default: "15m",
+      placeholder: "15m, 1h, 2d",
+      description: "How long to wait before ticket can re-trigger"
+    }, {
+      displayName: "Skip Existing Matches",
+      name: "skipExistingMatches",
+      type: "boolean",
+      displayOptions: {
+        show: {
+          resource: [ "ticket" ]
+        }
+      },
+      default: !0,
+      description: "On creation or update, don't trigger for existing matches"
+    } ]
+  };
+  methods={
+    loadOptions: {
+      ...import_methods.loadOptions,
+      async loadOptions_service_statuses_all() {
+        let selectedBoardIds = [];
+        try {
+          const boardIds = this.getNodeParameter("boardIds", []);
+          Array.isArray(boardIds) && boardIds.length > 0 && (selectedBoardIds = boardIds);
+        } catch {}
+        let boards;
+        if (selectedBoardIds.length > 0) {
+          const boardConditions = selectedBoardIds.map(id => `id=${id}`).join(" or ");
+          boards = await import_client.connectWiseApiRequest.call(this, "GET", "/service/boards", {}, {
+            conditions: `(${boardConditions})`,
+            fields: "id,name",
+            orderBy: "name",
+            pageSize: 100
+          }, {
+            optionsCache: !0
+          });
+        } else boards = await import_client.connectWiseApiRequest.call(this, "GET", "/service/boards", {}, {
+          conditions: "inactiveFlag=false and projectFlag=false",
+          fields: "id,name",
+          orderBy: "name",
+          pageSize: 100
+        }, {
+          optionsCache: !0
+        });
+        const statusPromises = boards.map(async board => {
+          try {
+            return (await import_client.connectWiseApiRequest.call(this, "GET", `/service/boards/${board.id}/statuses`, {}, {
+              fields: "id,name",
+              orderBy: "sortOrder",
+              pageSize: 100
+            }, {
+              optionsCache: !0
+            })).map(status => ({
+              statusName: status.name,
+              boardName: board.name,
+              value: status.id
+            }));
+          } catch {
+            return [];
+          }
+        }), allStatuses = (await Promise.all(statusPromises)).flat();
+        return allStatuses.sort((a, b) => {
+          const nameCompare = a.statusName.localeCompare(b.statusName);
+          return nameCompare !== 0 ? nameCompare : a.boardName.localeCompare(b.boardName);
+        }), allStatuses.map(s => ({
+          name: s.statusName,
+          value: s.value,
+          description: s.boardName
+        }));
+      }
+    }
+  };
+  webhookMethods={
+    default: {
+      async checkExists() {
+        return !1;
+      },
+      async create() {
+        const webhookUrl = this.getNodeWebhookUrl("default") ?? "", {resource: resource, query: query, options: options} = getFilterParameters(this), node = this.getNode(), workflow = this.getWorkflow(), isTest = webhookUrl.includes("/webhook-test/");
+        try {
+          await notifyWebhookAction(this, {
+            action: "create",
+            webhookUrl: webhookUrl,
+            webhookId: node.webhookId,
+            type: resource,
+            query: query,
+            options: options,
+            isTest: isTest,
+            metadata: {
+              workflowId: workflow.id,
+              workflowName: workflow.name
+            }
+          });
+        } catch (error) {
+          throw console.error("Webhook registration failed:", formatWebhookError(error)), 
+          new import_n8n_workflow.NodeOperationError(node, formatWebhookError(error));
+        }
+        return !0;
+      },
+      async delete() {
+        const webhookUrl = this.getNodeWebhookUrl("default") ?? "", isTest = webhookUrl.includes("/webhook-test/");
+        if (isTest) return !0;
+        const {resource: resource} = getFilterParameters(this), node = this.getNode(), workflow = this.getWorkflow();
+        try {
+          await notifyWebhookAction(this, {
+            action: "delete",
+            webhookUrl: webhookUrl,
+            webhookId: node.webhookId,
+            type: resource,
+            isTest: isTest,
+            metadata: {
+              workflowId: workflow.id,
+              workflowName: workflow.name
+            }
+          });
+        } catch (error) {
+          console.error("Webhook deregistration failed:", formatWebhookError(error));
+        }
+        return !0;
+      }
+    }
+  };
+  async webhook() {
+    const req = this.getRequestObject(), workflow = this.getWorkflow(), executionId = this.getExecutionId(), baseUrl = this.getInstanceBaseUrl();
+    return {
+      workflowData: [ this.helpers.returnJsonArray(req.body) ],
+      webhookResponse: {
+        executionId: executionId,
+        workflowId: workflow.id,
+        executionUrl: executionId ? `${baseUrl}workflow/${workflow.id}/executions/${executionId}` : `${baseUrl}workflow/${workflow.id}/executions`
+      }
+    };
+  }
+}
+
+0 && (module.exports = {
+  ConnectWisePsaTrigger: ConnectWisePsaTrigger
+});

package/dist-community/nodes/ConnectWise/PSA/helpers/hint-collector.js

@@ -95,7 +95,7 @@ const HINT_TYPES = {
   accesskey_missing: {
     aggregate: "dedupe",
     type: "warning",
-    template: () => "🔑 An access key is needed to use this feature. Add one in your ConnectWise PSA credentials."
+    template: () => `🔑 An access key is needed to use this feature. Get one at <a href="https://link.mspcopilot.io/settings?tab=support" target="_blank">link.mspcopilot.io</a>, then edit this node's ConnectWise PSA credentials and paste it into the Access Key field.`
   },
   accesskey_invalid: {
     aggregate: "dedupe",

package/dist-community/nodes/ConnectWise/PSA/transport/version-check.js

@@ -39,7 +39,7 @@ module.exports = __toCommonJS(version_check_exports);
 
 var fs = __toESM(require("fs/promises")), path = __toESM(require("path")), os = __toESM(require("os")), import_common = require("../descriptions/common.descriptions"), import_hint_collector = require("../helpers/hint-collector");
 
-const CACHE_FILE_PATH = path.join(os.tmpdir(), "connectwise-n8n-version-cache.json"), CURRENT_VERSION = "0.2.4";
+const CACHE_FILE_PATH = path.join(os.tmpdir(), "connectwise-n8n-version-cache.json"), CURRENT_VERSION = "0.3.1";
 
 let inMemoryCache = null, cacheLoadPromise = null, fetchInProgress = !1;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mspcopilot/n8n-nodes-connectwise",
-  "version": "0.2.4",
+  "version": "0.3.1",
   "description": "n8n node to integrate with ConnectWise PSA",
   "keywords": [
     "n8n-community-node-package"
@@ -32,7 +32,8 @@
       "dist-community/credentials/ConnectWisePsaApi.credentials.js"
     ],
     "nodes": [
-      "dist-community/nodes/ConnectWise/PSA/ConnectWisePsa.node.js"
+      "dist-community/nodes/ConnectWise/PSA/ConnectWisePsa.node.js",
+      "dist-community/nodes/ConnectWise/PSA/ConnectWisePsaTrigger.node.js"
     ]
   },
   "dependencies": {