@mspcopilot/n8n-nodes-connectwise 0.1.8 → 0.2.0

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

@@ -117,7 +117,7 @@ class ConnectWisePsaApi {
     name: "checkForUpdates",
     type: "boolean",
     default: !0,
-    hint: "Current version: 0.1.8 (community edition)",
+    hint: "Current version: 0.2.0 (community edition)",
     description: "Check for new versions of this node package and show notifications when updates are available"
   } ];
   async authenticate(credentials, requestOptions) {

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

@@ -31,7 +31,7 @@ __export(ConnectWisePsa_node_exports, {
 
 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_diagnostics = require("./schema/resources/diagnostics.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_ticketTask = require("./schema/resources/ticketTask.schema"), import_timeEntry = require("./schema/resources/timeEntry.schema"), import_custom = require("./schema/resources/custom.schema");
+var import_n8n_workflow = require("n8n-workflow"), import_methods = require("./methods"), import_hint_collector = require("./helpers/hint-collector"), 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_diagnostics = require("./schema/resources/diagnostics.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_ticketTask = require("./schema/resources/ticketTask.schema"), import_timeEntry = require("./schema/resources/timeEntry.schema"), import_custom = require("./schema/resources/custom.schema");
 
 const resources = {
   activity: {
@@ -74,7 +74,7 @@ const resources = {
 
 class ConnectWisePsa {
   constructor() {
-    console.log(`🔌 ConnectWise PSA Node Loaded | 📦 v0.1.8 | 🏗️  Build: ${"community".toUpperCase()} (${"prod".toUpperCase()} mode)`);
+    console.log(`🔌 ConnectWise PSA Node Loaded | 📦 v0.2.0 | 🏗️  Build: ${"community".toUpperCase()} (${"prod".toUpperCase()} mode)`);
   }
   description={
     displayName: "ConnectWise PSA",
@@ -159,26 +159,31 @@ class ConnectWisePsa {
   };
   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;
+    (0, import_hint_collector.initHints)(this);
+    try {
+      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;
       }
-      throw error;
+      return [ returnData ];
+    } finally {
+      (0, import_hint_collector.flushHints)(this);
     }
-    return [ returnData ];
   }
 }
 

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

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

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

@@ -0,0 +1,187 @@
+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 hint_collector_exports = {};
+
+__export(hint_collector_exports, {
+  flushHints: () => flushHints,
+  hint: () => hint,
+  initHints: () => initHints
+});
+
+module.exports = __toCommonJS(hint_collector_exports);
+
+var import_common = require("../descriptions/common.descriptions");
+
+const HINT_TYPES = {
+  items_retrieved: {
+    aggregate: "sum",
+    template: (total, count) => count === 1 ? `Retrieved ${total} items` : `Retrieved ${total} items across ${count} API calls`
+  },
+  pagination_limit: {
+    aggregate: "dedupe",
+    template: data => `Pagination limit reached: Retrieved ${data.itemCount} items across ${data.maxPages} pages. Additional records may exist.`
+  },
+  cache_hit: {
+    aggregate: "count",
+    template: count => count === 1 ? "1 request served from cache" : `${count} requests served from cache`
+  },
+  cache_stored: {
+    aggregate: "latest",
+    template: ttl => `Response cached for ${ttl}`
+  },
+  cache_invalidated: {
+    aggregate: "count",
+    template: count => count === 1 ? "Cache entry invalidated" : `${count} cache entries invalidated`
+  },
+  cache_upgrade: {
+    aggregate: "dedupe",
+    template: () => `✨ Caching is available for supporters only. Learn more at <a href="https://${import_common.SUPPORTER_URL}">${import_common.SUPPORTER_URL.split("?")[0]}</a>`
+  },
+  cache_error: {
+    aggregate: "dedupe",
+    template: error => `⚠️ Cache error: ${error}`
+  },
+  version_update: {
+    aggregate: "dedupe",
+    template: data => `🎉 ConnectWise PSA Node v${data.version} is available! <a href="https://${import_common.CHANGELOG_URL}" target="_blank">View changelog</a>` + (data.message ? `<br>${data.message}` : "")
+  },
+  pro_upgrade: {
+    aggregate: "dedupe",
+    template: () => `✨ This helpful feature is available to supporters. See <a href="https://${import_common.SUPPORTER_URL}">${import_common.SUPPORTER_URL.split("?")[0]}</a> for other benefits.<br><br><hr><br>Simplify and speed up your development with these other functions. <ul><li>Smart Alert Consolidation</li><li>Reports</li><li>Ticket Management</li></ul>`
+  },
+  custom: {
+    aggregate: "dedupe",
+    template: message => message
+  }
+}, collectors = /* @__PURE__ */ new WeakMap;
+
+function initHints(ctx) {
+  collectors.set(ctx, {
+    values: /* @__PURE__ */ new Map
+  });
+}
+
+function hint(ctx, type, value) {
+  const collector = collectors.get(ctx);
+  if (!collector) {
+    emitHintDirectly(ctx, type, value);
+    return;
+  }
+  let values = collector.values.get(type);
+  switch (values || (values = [], collector.values.set(type, values)), (HINT_TYPES[type] || HINT_TYPES.custom).aggregate) {
+   case "dedupe":
+    values.length === 0 && values.push(value), type === "custom" && !values.includes(value) && values.push(value);
+    break;
+
+   case "count":
+    values.push(1);
+    break;
+
+   case "sum":
+    values.push(typeof value == "number" ? value : 0);
+    break;
+
+   case "latest":
+    values.length = 0, values.push(value);
+    break;
+  }
+}
+
+function flushHints(ctx) {
+  const collector = collectors.get(ctx);
+  if (!collector) return;
+  if (!("addExecutionHints" in ctx)) {
+    collectors.delete(ctx);
+    return;
+  }
+  const hints = [];
+  for (const [type, values] of collector.values) {
+    if (values.length === 0) continue;
+    const config = HINT_TYPES[type] || HINT_TYPES.custom;
+    let message;
+    switch (config.aggregate) {
+     case "dedupe":
+      if (type === "custom") {
+        for (const val of values) val !== void 0 && hints.push({
+          message: config.template(val),
+          location: "outputPane"
+        });
+        continue;
+      }
+      message = config.template(values[0]);
+      break;
+
+     case "count":
+      message = config.template(values.length);
+      break;
+
+     case "sum":
+      const total = values.reduce((acc, v) => acc + (typeof v == "number" ? v : 0), 0);
+      message = config.template(total, values.length);
+      break;
+
+     case "latest":
+      message = config.template(values[values.length - 1]);
+      break;
+
+     default:
+      message = config.template(values[0]);
+    }
+    hints.push({
+      message: message,
+      location: "outputPane"
+    });
+  }
+  hints.length > 0 && ctx.addExecutionHints(...hints), collectors.delete(ctx);
+}
+
+function emitHintDirectly(ctx, type, value) {
+  if (!("addExecutionHints" in ctx)) return;
+  const config = HINT_TYPES[type] || HINT_TYPES.custom;
+  let message;
+  switch (config.aggregate) {
+   case "count":
+    message = config.template(1);
+    break;
+
+   case "sum":
+    message = config.template(value ?? 0, 1);
+    break;
+
+   default:
+    message = config.template(value);
+  }
+  ctx.addExecutionHints({
+    message: message,
+    location: "outputPane"
+  });
+}
+
+0 && (module.exports = {
+  flushHints: flushHints,
+  hint: hint,
+  initHints: initHints
+});

package/dist-community/nodes/ConnectWise/PSA/helpers/utils.js

@@ -35,13 +35,12 @@ __export(utils_exports, {
 
 module.exports = __toCommonJS(utils_exports);
 
+var import_hint_collector = require("./hint-collector");
+
 const ms = require("ms");
 
 function returnProOnlyMessage(context, itemIndex = 0) {
-  return "addExecutionHints" in context && context.addExecutionHints({
-    message: '✨ This helpful feature is available to supporters. See <a href="https://mspcopilot.io/support?utm_source=n8n">MSPCopilot.io/support</a> for other benefits.<br><br><hr><br>Simplify and speed up your development with these other functions. <ul><li>Smart Alert Consolidation</li><li>Reports</li><li>Ticket Management</li></ul>',
-    location: "outputPane"
-  }), context.helpers.constructExecutionMetaData(context.helpers.returnJsonArray([]), {
+  return (0, import_hint_collector.hint)(context, "pro_upgrade"), context.helpers.constructExecutionMetaData(context.helpers.returnJsonArray([]), {
     itemData: {
       item: itemIndex
     }

package/dist-community/nodes/ConnectWise/PSA/schema/converter/reference.generator.js

@@ -36,6 +36,11 @@ module.exports = __toCommonJS(reference_generator_exports);
 
 var import_transport = require("../../transport"), import_references = require("../references"), import_reports_descriptions = require("../reports-descriptions");
 
+function buildRecordUrl(credentials, recordType, recordId) {
+  const isCustom = credentials.site === "custom", apiHost = isCustom ? credentials.customServer : credentials.site, hostname = !isCustom && apiHost.startsWith("api-") ? apiHost.replace("api-", "") : apiHost, version = (credentials.apiPath || import_transport.DEFAULT_API_PATH).split("/")[0];
+  return `https://${hostname}/${version}/services/system_io/router/openrecord.rails?recordType=${recordType}&recid=${recordId}&companyName=${credentials.companyId}`;
+}
+
 const NOT_SPECIFIED_VALUE = "", NOT_SPECIFIED_DISPLAY = " ";
 
 function getNestedProperty(obj, path) {
@@ -90,14 +95,20 @@ async function loadOptionsCore(config, referenceKey) {
   }
   let endpoint;
   if (typeof configWithDefaults.endpoint == "function") {
-    endpoint = configWithDefaults.endpoint(allParams);
-    const serviceBoardsMatch = endpoint.match(/^\/service\/boards\/([^\/]+)/);
-    if (serviceBoardsMatch) {
-      const boardId = serviceBoardsMatch[1];
-      if (isNaN(Number(boardId))) return [ {
-        name: "Cannot Lookup by Name, Use Expression to Specify Value",
-        value: NOT_SPECIFIED_VALUE
-      } ];
+    if (endpoint = configWithDefaults.endpoint(allParams), endpoint.includes("/undefined/") || endpoint.includes("//") || endpoint.endsWith("/undefined")) return [ {
+      name: NOT_SPECIFIED_DISPLAY,
+      value: NOT_SPECIFIED_VALUE
+    } ];
+    const numericIdPatterns = [ /^\/service\/boards\/([^\/]+)/, /^\/project\/projects\/([^\/]+)/ ];
+    for (const pattern of numericIdPatterns) {
+      const match = endpoint.match(pattern);
+      if (match) {
+        const idValue = match[1];
+        if (isNaN(Number(idValue))) return [ {
+          name: NOT_SPECIFIED_DISPLAY,
+          value: NOT_SPECIFIED_VALUE
+        } ];
+      }
     }
   } else endpoint = configWithDefaults.endpoint;
   const items = await import_transport.connectWiseApiRequest.call(this, "GET", endpoint, {}, queryParams, {
@@ -152,9 +163,18 @@ async function searchConnectWise(referenceKey, filter) {
       const baseConditions = config.conditions ? config.conditions(params) : "";
       return conditions && baseConditions ? `${baseConditions} and ${conditions}` : conditions || baseConditions;
     }
-  };
+  }, options = await loadOptionsCore.call(this, searchConfig, referenceKey);
+  if (config.recordType) try {
+    const credentials = await this.getCredentials("connectWisePsaApi");
+    return {
+      results: options.map(option => option.value === "" ? option : {
+        ...option,
+        url: buildRecordUrl(credentials, config.recordType, option.value)
+      })
+    };
+  } catch {}
   return {
-    results: await loadOptionsCore.call(this, searchConfig, referenceKey)
+    results: options
   };
 }
 

package/dist-community/nodes/ConnectWise/PSA/schema/references.js

@@ -45,7 +45,8 @@ const allReferences = {
     conditions: () => "deletedFlag=false",
     fields: "id,name,identifier",
     pageSize: 300,
-    orderBy: "_info/lastUpdated desc"
+    orderBy: "_info/lastUpdated desc",
+    recordType: "CompanyFV"
   },
   company_countries: {
     endpoint: "/company/countries"

package/dist-community/nodes/ConnectWise/PSA/schema/resources/company.schema.js

@@ -115,16 +115,6 @@ const companyFields = [ {
       searchable: !0
     }
   } ]
-}, {
-  displayName: 'For information on how to create/update companies, check the <a href="temp">documentation</a>',
-  name: "importantNotice",
-  type: "notice",
-  default: "",
-  displayOptions: {
-    show: {
-      operation: [ "create", "update" ]
-    }
-  }
 }, {
   displayName: "Identifier",
   name: "identifier",
@@ -681,6 +671,7 @@ const companyFields = [ {
   description: "Manage ConnectWise companies",
   identifierField: "identifier",
   nameField: "name",
+  selectorField: "company",
   fieldDetection: {
     endpoint: "/company/companies",
     sampleSize: 3

package/dist-community/nodes/ConnectWise/PSA/schema/resources/custom.schema.js

@@ -49,6 +49,26 @@ const customFields = [ {
     value: "getAll",
     description: "Get many via custom endpoint (GET)",
     action: "Custom Get"
+  }, {
+    name: "POST (Create)",
+    value: "create",
+    description: "Create via custom endpoint (POST)",
+    action: "Custom Create"
+  }, {
+    name: "DELETE",
+    value: "delete",
+    description: "Delete via custom endpoint (DELETE)",
+    action: "Custom Delete"
+  }, {
+    name: "PUT (Replace)",
+    value: "replace",
+    description: "Replace via custom endpoint (PUT)",
+    action: "Custom Replace"
+  }, {
+    name: "PATCH (Update)",
+    value: "update",
+    description: "Update via custom endpoint (PATCH)",
+    action: "Custom Update"
   } ],
   default: "getAll"
 }, {
@@ -62,7 +82,7 @@ const customFields = [ {
     }
   },
   default: "",
-  hint: `View list of endpoints in the <a href="https://${import_common2.DOCURL_PREFIX}/endpoints">documentation</a>`,
+  hint: `View list of endpoints in the <a href="https://${import_common2.DOCURL_PREFIX}/connectwise-api">documentation</a>`,
   placeholder: "e.g., /company/companies/:id or https://api.connectwise.com/...",
   description: "The API endpoint. Can be a full URL or a partial path. Include any parameters like the ID directly in the URL."
 }, {

package/dist-community/nodes/ConnectWise/PSA/schema/resources/diagnostics.schema.js

@@ -38,6 +38,8 @@ __export(diagnostics_schema_exports, {
 
 module.exports = __toCommonJS(diagnostics_schema_exports);
 
+var import_hint_collector = require("../../helpers/hint-collector");
+
 const diagnosticsFields = [ {
   displayName: "Operation",
   name: "operation",
@@ -70,10 +72,8 @@ async function execute(operation, i) {
       clearedCount: clearedCount,
       message: `Cleared ${clearedCount} cache entries`
     };
-    return this.addExecutionHints({
-      message: `Cache cleared: ${clearedCount} entries removed`,
-      location: "outputPane"
-    }), this.helpers.constructExecutionMetaData(this.helpers.returnJsonArray(result), {
+    return (0, import_hint_collector.hint)(this, "custom", `Cache cleared: ${clearedCount} entries removed`), 
+    this.helpers.constructExecutionMetaData(this.helpers.returnJsonArray(result), {
       itemData: {
         item: i
       }
@@ -88,10 +88,7 @@ async function execute(operation, i) {
       error: originalError,
       message: friendlyMessage
     };
-    return this.addExecutionHints({
-      message: friendlyMessage,
-      location: "outputPane"
-    }), this.helpers.constructExecutionMetaData(this.helpers.returnJsonArray(result), {
+    return (0, import_hint_collector.hint)(this, "custom", friendlyMessage), this.helpers.constructExecutionMetaData(this.helpers.returnJsonArray(result), {
       itemData: {
         item: i
       }

package/dist-community/nodes/ConnectWise/PSA/schema/resources/ticket.schema.js

@@ -160,6 +160,10 @@ const ticketFields = [ {
     }
   },
   modes: [ {
+    displayName: "ID",
+    name: "id",
+    type: "string"
+  }, {
     displayName: "From List",
     name: "list",
     type: "list",
@@ -256,7 +260,12 @@ const ticketFields = [ {
   },
   displayOptions: {
     show: {
-      operation: [ "create", "update" ]
+      operation: [ "create", "update" ],
+      board: [ {
+        _cnd: {
+          exists: !0
+        }
+      } ]
     }
   },
   x_detectField: "auto"

package/dist-community/nodes/ConnectWise/PSA/schema/static-fields.js

@@ -408,7 +408,7 @@ const COMMON_FIELDS_NAME = "Common Fields", staticFieldDefinitions = {
       value: "__ALL_FIELDS_OVERRIDE__"
     }, {
       name: COMMON_FIELDS_NAME,
-      value: "id,summary,recordType,board/id,board/name,status/id,status/name,company/id,company/identifier,company/name,agreement/name,agreement/type,contact/name,contactEmailAddress,team/name,priority/name,source/name,customerUpdatedFlag,closedFlag,location/name,department/identifier,sla/name,_info/lastUpdated,_info/updatedBy,_info/dateEntered,__customFields,$$customFields,type/name,subType/name,item/name,owner/identifier,budgetHours,actualHours,resources,closedDate,closedBy,project/id,project/name,phase/name"
+      value: "id,summary,recordType,board/id,board/name,status/id,status/name,company/id,company/identifier,company/name,agreement/name,agreement/type,contact/id,contact/name,contactEmailAddress,team/name,priority/name,source/name,customerUpdatedFlag,closedFlag,location/name,department/identifier,sla/name,_info/lastUpdated,_info/updatedBy,_info/dateEntered,__customFields,$$customFields,type/name,subType/name,item/name,owner/identifier,budgetHours,actualHours,resources,closedDate,closedBy,project/id,project/name,phase/name"
     }, {
       name: "ID",
       value: "id"

package/dist-community/nodes/ConnectWise/PSA/transport/cache.js

@@ -37,17 +37,27 @@ module.exports = __toCommonJS(cache_exports);
 
 var import_utils = require("../helpers/utils");
 
-let cacheClient = null, Redis = null;
+let cacheClient = null, Redis = null, lastConnectionError = null;
+
+function getBestErrorMessage(operationError) {
+  return lastConnectionError || operationError;
+}
 
 async function getCacheClient() {
   return null;
 }
 
 async function getCached(key) {
-  return null;
+  return {
+    data: null
+  };
 }
 
-async function setCached(key, data, ttl) {}
+async function setCached(key, data, ttl) {
+  return {
+    success: !1
+  };
+}
 
 async function deleteCached(key) {
   return !1;

package/dist-community/nodes/ConnectWise/PSA/transport/client.js

@@ -41,7 +41,7 @@ __export(client_exports, {
 
 module.exports = __toCommonJS(client_exports);
 
-var import_n8n_workflow = require("n8n-workflow"), import_logging = require("../helpers/logging");
+var import_n8n_workflow = require("n8n-workflow"), import_logging = require("../helpers/logging"), import_hint_collector = require("../helpers/hint-collector");
 
 const DEFAULT_API_PATH = "v4_6_release/apis/3.0";
 
@@ -92,7 +92,7 @@ async function connectWiseApiRequest(method, endpoint, body = {}, qs = {}, optio
     console.warn("Version check module load failed:", error);
   }
   if ("getNodeParameter" in this && method === "GET") try {
-    this.getNodeParameter("cacheResponse", 0, !1) && "addExecutionHints" in this;
+    const cacheResponse = this.getNodeParameter("cacheResponse", 0, !1);
   } catch {}
   return await connectWiseHttpRequest.call(this, method, endpoint, body, qs, options);
 }
@@ -134,9 +134,9 @@ async function connectWiseHttpRequest(method, endpoint, body = {}, qs = {}, opti
       if (pageNumber > maxPages) {
         const itemCount = isReportFormat ? reportResult?.row_values?.length || 0 : returnData.length;
         console.log(`⚠️ Reached maximum page limit (${maxPages} pages, ${itemCount} records). Some results may be missing.`), 
-        "addExecutionHints" in this && this.addExecutionHints({
-          message: `Pagination limit reached: Retrieved ${itemCount} items across ${maxPages} pages. Additional records may exist.`,
-          location: "outputPane"
+        (0, import_hint_collector.hint)(this, "pagination_limit", {
+          itemCount: itemCount,
+          maxPages: maxPages
         });
         break;
       }
@@ -162,23 +162,18 @@ async function connectWiseHttpRequest(method, endpoint, body = {}, qs = {}, opti
         hasMultiplePages = !0;
       }
       if (hasMultiplePages) {
-        const currentPageCount = isReportFormat ? responseData.row_values?.length || 0 : responseData.length, totalCount = isReportFormat ? reportResult.row_values.length : returnData.length;
-        console.log(`✅ Page ${pageNumber}: received ${currentPageCount} items (total so far: ${totalCount})`);
+        const currentPageCount = isReportFormat ? responseData.row_values?.length || 0 : responseData.length, totalCount2 = isReportFormat ? reportResult.row_values.length : returnData.length;
+        console.log(`✅ Page ${pageNumber}: received ${currentPageCount} items (total so far: ${totalCount2})`);
       }
       pageNumber++;
     } while (isReportFormat ? responseData.row_values && responseData.row_values.length === pageSize : responseData.length === pageSize);
     if (hasMultiplePages) {
-      const totalCount = isReportFormat ? reportResult.row_values.length : returnData.length;
-      console.log(`📊 Pagination complete: ${totalCount} total items\n`);
+      const totalCount2 = isReportFormat ? reportResult.row_values.length : returnData.length;
+      console.log(`📊 Pagination complete: ${totalCount2} total items\n`);
     }
-    if ("addExecutionHints" in this) {
-      const totalCount = isReportFormat ? reportResult?.row_values?.length || 0 : returnData.length;
-      totalCount > 0 && this.addExecutionHints({
-        message: `Retrieved ${totalCount} items${pageNumber > 2 ? ` across ${pageNumber - 1} pages` : ""}`,
-        location: "outputPane"
-      });
-    }
-    return isReportFormat ? reportResult : returnData;
+    const totalCount = isReportFormat ? reportResult?.row_values?.length || 0 : returnData.length;
+    return totalCount > 0 && (0, import_hint_collector.hint)(this, "items_retrieved", totalCount), 
+    isReportFormat ? reportResult : returnData;
   } else {
     options.limit && (qs.pageSize = options.limit), Object.keys(qs).length && (requestOptions.qs = qs);
     try {

package/dist-community/nodes/ConnectWise/PSA/transport/operations.js

@@ -28,6 +28,7 @@ var operations_exports = {};
 __export(operations_exports, {
   buildEndpointUrl: () => buildEndpointUrl,
   extractOperationParams: () => extractOperationParams,
+  fetchRecordById: () => fetchRecordById,
   recordCreate: () => recordCreate,
   recordDelete: () => recordDelete,
   recordGet: () => recordGet,
@@ -84,24 +85,29 @@ function buildEndpointUrl(schema, operation, params = {}) {
   };
 }
 
+async function fetchRecordById(context, schema, params, qs) {
+  const {method: method, endpoint: endpoint} = buildEndpointUrl(schema, "get", params);
+  return import_client.connectWiseApiRequest.call(context, method, endpoint, {}, qs);
+}
+
 async function recordGet(context, schema, params, qs) {
-  if (params.company && typeof params.company == "object") {
-    const companyValue = params.company;
-    if (companyValue.mode === "identifier") {
-      const identifierField = schema.identifierField || "id", searchCondition = `${identifierField}="${companyValue.value}"`, searchQs = {
+  const selectorField = schema.selectorField || "id", selectorValue = params[selectorField];
+  if (selectorValue && typeof selectorValue == "object" && "mode" in selectorValue) {
+    const locator = selectorValue;
+    if (locator.mode === "identifier") {
+      const identifierField = schema.identifierField || "id", searchCondition = `${identifierField}="${locator.value}"`, searchQs = {
         ...qs,
         conditions: searchCondition
       }, getAllEndpoint = buildEndpointUrl(schema, "getAll", params), results = await import_client.connectWiseApiRequest.call(context, getAllEndpoint.method, getAllEndpoint.endpoint, {}, searchQs);
-      if (!results || results.length === 0) throw new Error(`No ${schema.resource} found with ${identifierField}: ${companyValue.value}`);
+      if (!results || results.length === 0) throw new Error(`No ${schema.resource} found with ${identifierField}: ${locator.value}`);
       return results[0];
     } else {
       let id;
-      if (companyValue.mode === "id") id = companyValue.value; else if (companyValue.mode === "list" && companyValue.value) id = typeof companyValue.value == "object" && "value" in companyValue.value ? companyValue.value.value : companyValue.value; else throw new Error(`Please select a ${schema.resource} from the list or enter an ID`);
+      if (locator.mode === "id") id = locator.value; else if (locator.mode === "list" && locator.value) id = typeof locator.value == "object" && "value" in locator.value ? locator.value.value : locator.value; else throw new Error(`Please select a ${schema.resource} from the list or enter an ID`);
       params.id = id;
     }
   }
-  const {method: method, endpoint: endpoint} = buildEndpointUrl(schema, "get", params);
-  return await import_client.connectWiseApiRequest.call(context, method, endpoint, {}, qs);
+  return fetchRecordById(context, schema, params, qs);
 }
 
 async function recordGetAll(context, schema, params, qs, options) {
@@ -136,7 +142,10 @@ async function recordUpdate(context, schema, endpoint, index, qs) {
     let existingCustomFields = [];
     if (existingRecord) existingCustomFields = existingRecord.customFields || []; else {
       const params = extractOperationParams(context, index);
-      existingRecord = await recordGet(context, schema, params, {}), existingCustomFields = existingRecord.customFields || [];
+      existingRecord = await fetchRecordById(context, schema, {
+        id: params.id,
+        ticketType: params.ticketType
+      }, {}), existingCustomFields = existingRecord.customFields || [];
     }
     const fieldsArray = customFields && typeof customFields == "object" && "field" in customFields ? customFields.field || [] : Array.isArray(customFields) ? customFields : [], customFieldPatch = [ {
       op: "replace",
@@ -159,6 +168,7 @@ async function recordDelete(context, endpoint) {
 0 && (module.exports = {
   buildEndpointUrl: buildEndpointUrl,
   extractOperationParams: extractOperationParams,
+  fetchRecordById: fetchRecordById,
   recordCreate: recordCreate,
   recordDelete: recordDelete,
   recordGet: recordGet,

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

@@ -37,14 +37,12 @@ __export(version_check_exports, {
 
 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");
+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.1.8";
+const CACHE_FILE_PATH = path.join(os.tmpdir(), "connectwise-n8n-version-cache.json"), CURRENT_VERSION = "0.2.0";
 
 let inMemoryCache = null, cacheLoadPromise = null, fetchInProgress = !1;
 
-const notificationShown = /* @__PURE__ */ new WeakSet;
-
 async function initializeCache() {
   try {
     const fileContent = await fs.readFile(CACHE_FILE_PATH, "utf-8"), cacheEntry = JSON.parse(fileContent);
@@ -112,10 +110,10 @@ function checkForUpdatesAsync() {
 async function checkAndNotifyUpdate(context) {
   try {
     if (!(await context.getCredentials("connectWisePsaApi")).checkForUpdates) return;
-    checkForUpdatesAsync(), inMemoryCache?.updateAvailable && "addExecutionHints" in context && !notificationShown.has(context) && (context.addExecutionHints({
-      message: `🎉 ConnectWise PSA Node v${inMemoryCache.latest} is available! <a href="https://${import_common.CHANGELOG_URL}" target="_blank">View changelog</a>`,
-      location: "outputPane"
-    }), notificationShown.add(context));
+    checkForUpdatesAsync(), inMemoryCache?.updateAvailable && (0, import_hint_collector.hint)(context, "version_update", {
+      version: inMemoryCache.latest,
+      message: inMemoryCache.message
+    });
   } catch (error) {
     console.warn("⚠️ Version check failed:", error);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mspcopilot/n8n-nodes-connectwise",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "n8n node to integrate with ConnectWise PSA",
   "keywords": [
     "n8n-community-node-package"
@@ -67,4 +67,4 @@
     "registry": "https://registry.npmjs.org",
     "access": "public"
   }
-}
+}