@mspcopilot/n8n-nodes-connectwise 0.1.1

package/README.md

@@ -0,0 +1,59 @@
+# n8n-nodes-connectwise
+
+n8n node to integrate with ConnectWise PSA (Manage)
+
+This aims to be a `better-than-first-party` implementation of a ConnectWise integration
+for n8n. This has been an exhaustive, and rewarding build of all the functionality
+we've desired after 2+ years of using n8n at our MSP.
+
+No automation platform we've ever used has this speed of development, reliability,
+and extensibility.
+
+**WARNING**: This is beta. Just because it works for us, doesn't mean there won't be obvious bugs I haven't found yet. :)
+
+## Covered Actions (so far)
+- Activities
+- Companies
+- Contacts
+- Members
+- Tickets
+- Ticket Notes
+- Time Entries
+
+## Features
+
+**Lookup fields for almost all options**: Don't lookup ID numbers of boards or statuses. Just quickly create your workflow.
+![Create Ticket](docs/assets/screenshots/create-ticket.png)
+
+**Override fields easily by drag & drop**: Any field (including nested) in **Additional Assignments** will override any options above--including blank ones.
+
+**Quickly choose sort and field names**: Quickly identify only the fields you need or a sort. Intelligently chosen defaults. Override them with an expression if you need more customization.
+![Field Sort](docs/assets/screenshots/field-sort.png)
+![Field List](docs/assets/screenshots/field-list.png)
+
+## Roadmap
+
+### Built (in private testing)
+- Custom fields
+- Caching
+- IF Schedule (checks timezones, calendars, etc. in a single action)
+- Ticket Creation with Deduplication/Consolidation
+- Many more endpoints (which ones do you want first?)
+- Reports
+
+### Future
+- Intelligent upserts (find possible duplicates to update before inserting)
+- Auto link to IT Glue assets, Microsoft tenants, etc.
+- More n8n nodes
+  - [UniFi Site Manager](https://www.npmjs.com/package/@mspcopilot/n8n-nodes-unifi-sitemanager)
+- Nodes in use internally (testing):
+  - Microsoft Partner GDAP
+  - IT Glue
+  - Zabbix
+  - UniFi Local Controller
+
+## When?
+
+Sign up to [tell me when stuff happens](https://tally.so/r/3jjKQ6)
+
+I'll probably post on [r/msp](https://www.reddit.com/r/msp/) too

package/dist-community/LICENSE.md

@@ -0,0 +1,21 @@
+# Sustainable Use License (SUL-1.0)
+
+Copyright (c) 2025 MSP Copilot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use,
+copy, modify, merge, publish, distribute, and/or sublicense copies of the
+Software, subject to the following conditions:
+
+1. You may not use the Software to provide a commercial software-as-a-service
+   (SaaS) product or service that competes with this project.
+
+2. You must retain the above copyright notice and this permission notice in
+   all copies or substantial portions of the Software.
+
+3. 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.
+
+For the full terms of this license, see:
+https://spdx.org/licenses/SUL-1.0.html

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

@@ -0,0 +1,142 @@
+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 ConnectWisePsaApi_credentials_exports = {};
+
+__export(ConnectWisePsaApi_credentials_exports, {
+  ConnectWisePsaApi: () => ConnectWisePsaApi
+});
+
+module.exports = __toCommonJS(ConnectWisePsaApi_credentials_exports);
+
+var import_transport = require("../nodes/ConnectWise/PSA/transport");
+
+class ConnectWisePsaApi {
+  name="connectWisePsaApi";
+  displayName="ConnectWise PSA API";
+  documentationUrl="https://{$DOCURL_PREFIX}connectwise/psa{$DOCURL_SUFFIX}";
+  icon="file:connectwise.svg";
+  properties=[ {
+    displayName: "ConnectWise Site",
+    name: "site",
+    type: "options",
+    options: [ {
+      name: "North America (api-na.myconnectwise.net)",
+      value: "api-na.myconnectwise.net"
+    }, {
+      name: "Australia (api-au.myconnectwise.net)",
+      value: "api-au.myconnectwise.net"
+    }, {
+      name: "Europe (api-eu.myconnectwise.net)",
+      value: "api-eu.myconnectwise.net"
+    }, {
+      name: "Staging (api-staging.connectwisedev.com)",
+      value: "api-staging.connectwisedev.com"
+    }, {
+      name: "Custom…",
+      value: "custom"
+    } ],
+    default: "api-na.myconnectwise.net",
+    description: "The URL of your ConnectWise Manage instance."
+  }, {
+    displayName: "Custom Server",
+    name: "customServer",
+    type: "string",
+    default: "",
+    placeholder: "e.g. psa.mycompany.com",
+    description: 'Only fill this if you selected "Custom…" above. Enter your server hostname without https://.',
+    displayOptions: {
+      show: {
+        site: [ "custom" ]
+      }
+    }
+  }, {
+    displayName: "Company ID",
+    name: "companyId",
+    type: "string",
+    default: "",
+    description: "Your ConnectWise Company ID.",
+    required: !0
+  }, {
+    displayName: "Client ID",
+    name: "clientId",
+    type: "string",
+    default: "",
+    hint: 'The Client ID from your ConnectWise developer account. Create them at <a href="https://developer.connectwise.com/ClientID">https://developer.connectwise.com/ClientID</a>.',
+    required: !0
+  }, {
+    displayName: "Public Key",
+    name: "publicKey",
+    type: "string",
+    default: "",
+    typeOptions: {
+      password: !0
+    },
+    required: !0
+  }, {
+    displayName: "Private Key",
+    name: "privateKey",
+    type: "string",
+    default: "",
+    typeOptions: {
+      password: !0
+    },
+    required: !0
+  }, {
+    displayName: "API Path",
+    name: "apiPath",
+    type: "string",
+    default: "",
+    placeholder: import_transport.DEFAULT_API_PATH,
+    hint: `Leave blank to use the default API path (${import_transport.DEFAULT_API_PATH})`,
+    description: "Custom API version path. Leave empty to use the default."
+  }, {
+    displayName: "Check for Updates",
+    name: "checkForUpdates",
+    type: "boolean",
+    default: !1,
+    hint: "Current version: 0.1.1 (community edition)",
+    description: "Check for new versions of this node package and show notifications when updates are available"
+  } ];
+  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}`), 
+    requestOptions.headers = {
+      ...requestOptions.headers,
+      clientId: credentials.clientId,
+      Authorization: `Basic ${base64Auth}`
+    }, requestOptions;
+  }
+  test={
+    request: {
+      url: `={{$credentials.apiPath || "${import_transport.DEFAULT_API_PATH}"}}/company/companies`,
+      method: "GET"
+    }
+  };
+}
+
+0 && (module.exports = {
+  ConnectWisePsaApi: ConnectWisePsaApi
+});

package/dist-community/credentials/connectwise.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="244 340 504 252"><g transform="scale(2)"> 	<path d="M298.529 207.425C283.091 198.75 265.737 194.126 247.982 194.126C230.228 194.126 212.894 198.75 197.436 207.425C203.628 213.64 209.419 220.554 214.79 228.127C224.057 241.192 230.249 253.579 233.956 262.169L247.982 239.114L262.009 262.169C265.716 253.579 271.887 241.192 281.175 228.127C286.545 220.554 292.358 213.661 298.529 207.425ZM368.957 182.46C350.529 186.087 333.806 193.914 318.937 205.771C315.61 208.422 312.387 211.264 309.249 214.318C302.973 220.448 297.055 227.363 291.537 235.105C275.951 256.973 269.528 277.335 269.465 277.547C268.749 279.859 266.79 281.534 264.41 281.895C264.115 281.937 263.799 281.959 263.504 281.959C261.44 281.959 259.503 280.941 258.323 279.18L247.982 263.675L237.641 279.18C236.483 280.941 234.524 281.959 232.46 281.959C232.165 281.959 231.849 281.937 231.555 281.895C229.175 281.534 227.216 279.859 226.5 277.547C226.437 277.356 220.013 256.973 204.428 235.126C198.868 227.342 192.907 220.363 186.589 214.212C185.873 213.512 185.136 212.813 184.399 212.134C184.378 212.113 184.357 212.091 184.336 212.07C181.956 209.864 179.513 207.786 177.048 205.792C162.179 193.914 145.457 186.109 127.028 182.482C123.658 181.782 121.447 178.494 122.121 175.079C122.774 171.685 126.059 169.458 129.429 170.116C150.785 174.337 170.498 183.966 187.726 198.453C205.923 187.381 226.689 181.421 248.003 181.421C269.317 181.421 290.083 187.36 308.28 198.453C325.508 183.966 345.2 174.337 366.577 170.116C369.968 169.458 373.233 171.664 373.886 175.079C374.539 178.494 372.327 181.782 368.957 182.46ZM169.129 212.41C147.584 232.114 133.389 259.242 129.198 288.767C128.713 292.225 131.093 295.449 134.547 295.936C138.001 296.424 141.181 294.027 141.666 290.549C145.436 263.93 158.199 239.517 177.596 221.785C178.754 220.724 179.955 219.685 181.155 218.667C178.017 215.676 174.795 212.876 171.467 210.31C170.688 211.01 169.909 211.688 169.129 212.41ZM366.788 288.767C367.273 292.225 364.893 295.449 361.439 295.936C361.144 295.979 360.828 296 360.533 296C357.458 296 354.762 293.709 354.299 290.549C350.529 263.93 337.766 239.517 318.369 221.785C317.189 220.724 316.01 219.685 314.809 218.667C317.947 215.676 321.17 212.876 324.497 210.31C325.298 210.988 326.077 211.688 326.856 212.41C348.423 232.114 362.597 259.242 366.788 288.767Z" fill="#24336A"></path> </g></svg>

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

@@ -0,0 +1,180 @@
+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 ConnectWisePsa_node_exports = {};
+
+__export(ConnectWisePsa_node_exports, {
+  ConnectWisePsa: () => ConnectWisePsa
+});
+
+module.exports = __toCommonJS(ConnectWisePsa_node_exports);
+
+var import_n8n_workflow = require("n8n-workflow"), import_methods = require("./methods"), import_fieldOptions = require("./methods/fieldOptions"), import_activity = require("./schema/resources/activity.schema"), import_company = require("./schema/resources/company.schema"), import_contact = require("./schema/resources/contact.schema"), import_members = require("./schema/resources/members.schema"), import_reports = require("./schema/resources/reports.schema"), import_ticket = require("./schema/resources/ticket.schema"), import_ticketNote = require("./schema/resources/ticketNote.schema"), import_timeEntry = require("./schema/resources/timeEntry.schema"), import_custom = require("./schema/resources/custom.schema");
+
+const resources = {
+  activity: {
+    schema: import_activity.activitySchema,
+    execute: import_activity.execute
+  },
+  company: {
+    schema: import_company.companySchema,
+    execute: import_company.execute
+  },
+  contact: {
+    schema: import_contact.contactSchema,
+    execute: import_contact.execute
+  },
+  members: {
+    schema: import_members.membersSchema,
+    execute: import_members.execute
+  },
+  ticket: {
+    schema: import_ticket.ticketSchema,
+    execute: import_ticket.execute
+  },
+  ticketNote: {
+    schema: import_ticketNote.ticketNoteSchema,
+    execute: import_ticketNote.execute
+  },
+  timeEntry: {
+    schema: import_timeEntry.timeEntrySchema,
+    execute: import_timeEntry.execute
+  },
+  custom: {
+    schema: import_custom.customSchema,
+    execute: import_custom.execute
+  }
+};
+
+class ConnectWisePsa {
+  constructor() {
+    console.log(`🔌 ConnectWise PSA Node Loaded | 🏗️  Build: ${"community".toUpperCase()} (${"prod".toUpperCase()} mode)`);
+  }
+  description={
+    displayName: "ConnectWise PSA",
+    name: "connectWisePsa",
+    icon: "file:connectwise.svg",
+    group: [ "transform" ],
+    version: 1,
+    subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+    description: "Consume ConnectWise PSA API",
+    defaults: {
+      name: "ConnectWise PSA"
+    },
+    inputs: [ import_n8n_workflow.NodeConnectionType.Main ],
+    outputs: [ import_n8n_workflow.NodeConnectionType.Main ],
+    credentials: [ {
+      name: "connectWisePsaApi",
+      required: !0
+    } ],
+    hints: Object.values(resources).filter(({schema: schema}) => schema.hints).flatMap(({schema: schema}) => schema.hints),
+    properties: [ {
+      displayName: "Resource",
+      name: "resource",
+      type: "options",
+      noDataExpression: !0,
+      default: "",
+      options: Object.entries(resources).map(([value, {schema: schema}]) => ({
+        name: schema.displayName,
+        value: value
+      }))
+    }, ...Object.entries(resources).flatMap(([resourceName, {schema: schema}]) => {
+      const processedFields = [];
+      for (const field of schema.fields) {
+        const operations = field.displayOptions?.show?.operation, operationsArray = Array.isArray(operations) ? operations : operations ? [ operations ] : [ "create", "update" ];
+        if (field.x_requiredOnCreate === !0 && operationsArray.includes("create") && operationsArray.length > 1) {
+          const createField = {
+            ...field
+          };
+          delete createField.x_requiredOnCreate, createField.required = !0, createField.displayOptions = {
+            ...field.displayOptions,
+            show: {
+              ...field.displayOptions?.show,
+              resource: [ resourceName ],
+              operation: [ "create" ]
+            }
+          }, processedFields.push(createField);
+          const otherOps = operationsArray.filter(op => op !== "create"), updateField = {
+            ...field
+          };
+          delete updateField.x_requiredOnCreate, delete updateField.required, updateField.displayOptions = {
+            ...field.displayOptions,
+            show: {
+              ...field.displayOptions?.show,
+              resource: [ resourceName ],
+              operation: otherOps
+            }
+          }, processedFields.push(updateField);
+        } else processedFields.push({
+          ...field,
+          displayOptions: {
+            show: {
+              ...field.displayOptions?.show,
+              resource: [ resourceName ]
+            }
+          }
+        });
+      }
+      return processedFields;
+    }) ]
+  };
+  methods={
+    loadOptions: {
+      ...import_methods.loadOptions,
+      loadFieldsOptions: import_fieldOptions.loadFieldsOptions,
+      loadOrderByFieldsOptions: import_fieldOptions.loadOrderByFieldsOptions,
+      loadCustomFieldsOptions: import_fieldOptions.loadCustomFieldsOptions,
+      loadReportColumns: import_reports.loadReportColumns
+    },
+    listSearch: import_methods.listSearch
+  };
+  async execute() {
+    const items = this.getInputData(), returnData = [], resource = this.getNodeParameter("resource", 0), operation = this.getNodeParameter("operation", 0);
+    for (let i = 0; i < items.length; i++) try {
+      const resourceData = resources[resource];
+      if (!resourceData) throw new import_n8n_workflow.NodeOperationError(this.getNode(), `Resource ${resource} not found`);
+      const responseData = await resourceData.execute.call(this, operation, i);
+      returnData.push(...responseData);
+    } catch (error) {
+      if (this.continueOnFail()) {
+        const executionData = this.helpers.constructExecutionMetaData(this.helpers.returnJsonArray({
+          error: error.message
+        }), {
+          itemData: {
+            item: i
+          }
+        });
+        returnData.push(...executionData);
+        continue;
+      }
+      throw error;
+    }
+    return [ returnData ];
+  }
+}
+
+0 && (module.exports = {
+  ConnectWisePsa: ConnectWisePsa
+});

package/dist-community/nodes/ConnectWise/PSA/connectwise.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="244 340 504 252"><g transform="scale(2)"> 	<path d="M298.529 207.425C283.091 198.75 265.737 194.126 247.982 194.126C230.228 194.126 212.894 198.75 197.436 207.425C203.628 213.64 209.419 220.554 214.79 228.127C224.057 241.192 230.249 253.579 233.956 262.169L247.982 239.114L262.009 262.169C265.716 253.579 271.887 241.192 281.175 228.127C286.545 220.554 292.358 213.661 298.529 207.425ZM368.957 182.46C350.529 186.087 333.806 193.914 318.937 205.771C315.61 208.422 312.387 211.264 309.249 214.318C302.973 220.448 297.055 227.363 291.537 235.105C275.951 256.973 269.528 277.335 269.465 277.547C268.749 279.859 266.79 281.534 264.41 281.895C264.115 281.937 263.799 281.959 263.504 281.959C261.44 281.959 259.503 280.941 258.323 279.18L247.982 263.675L237.641 279.18C236.483 280.941 234.524 281.959 232.46 281.959C232.165 281.959 231.849 281.937 231.555 281.895C229.175 281.534 227.216 279.859 226.5 277.547C226.437 277.356 220.013 256.973 204.428 235.126C198.868 227.342 192.907 220.363 186.589 214.212C185.873 213.512 185.136 212.813 184.399 212.134C184.378 212.113 184.357 212.091 184.336 212.07C181.956 209.864 179.513 207.786 177.048 205.792C162.179 193.914 145.457 186.109 127.028 182.482C123.658 181.782 121.447 178.494 122.121 175.079C122.774 171.685 126.059 169.458 129.429 170.116C150.785 174.337 170.498 183.966 187.726 198.453C205.923 187.381 226.689 181.421 248.003 181.421C269.317 181.421 290.083 187.36 308.28 198.453C325.508 183.966 345.2 174.337 366.577 170.116C369.968 169.458 373.233 171.664 373.886 175.079C374.539 178.494 372.327 181.782 368.957 182.46ZM169.129 212.41C147.584 232.114 133.389 259.242 129.198 288.767C128.713 292.225 131.093 295.449 134.547 295.936C138.001 296.424 141.181 294.027 141.666 290.549C145.436 263.93 158.199 239.517 177.596 221.785C178.754 220.724 179.955 219.685 181.155 218.667C178.017 215.676 174.795 212.876 171.467 210.31C170.688 211.01 169.909 211.688 169.129 212.41ZM366.788 288.767C367.273 292.225 364.893 295.449 361.439 295.936C361.144 295.979 360.828 296 360.533 296C357.458 296 354.762 293.709 354.299 290.549C350.529 263.93 337.766 239.517 318.369 221.785C317.189 220.724 316.01 219.685 314.809 218.667C317.947 215.676 321.17 212.876 324.497 210.31C325.298 210.988 326.077 211.688 326.856 212.41C348.423 232.114 362.597 259.242 366.788 288.767Z" fill="#24336A"></path> </g></svg>

package/dist-community/nodes/ConnectWise/PSA/descriptions/common.descriptions.js

@@ -0,0 +1,46 @@
+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 common_descriptions_exports = {};
+
+__export(common_descriptions_exports, {
+  CHANGELOG_URL: () => CHANGELOG_URL,
+  DOCURL_PREFIX: () => DOCURL_PREFIX,
+  DOCURL_SUFFIX: () => DOCURL_SUFFIX,
+  VERSION_CHECK_CACHE_TTL: () => VERSION_CHECK_CACHE_TTL,
+  VERSION_CHECK_URL: () => VERSION_CHECK_URL
+});
+
+module.exports = __toCommonJS(common_descriptions_exports);
+
+const DOCURL_PREFIX = "mspcopilot.io/docs/", DOCURL_SUFFIX = "?utm_source=n8n_node_connectwise", CHANGELOG_URL = "mspcopilot.io/changelog", VERSION_CHECK_URL = "https://djstgzbunlbcnghwfzja.supabase.co/functions/v1/version-check/n8n-nodes-connectwise", VERSION_CHECK_CACHE_TTL = 6e5;
+
+0 && (module.exports = {
+  CHANGELOG_URL: CHANGELOG_URL,
+  DOCURL_PREFIX: DOCURL_PREFIX,
+  DOCURL_SUFFIX: DOCURL_SUFFIX,
+  VERSION_CHECK_CACHE_TTL: VERSION_CHECK_CACHE_TTL,
+  VERSION_CHECK_URL: VERSION_CHECK_URL
+});