n8n-nodes-halopsacomplete 2.10.1 → 5.1.0

package/README.md

@@ -2,6 +2,17 @@
 
 An n8n community node for integrating with HaloPSA API.
 
+## Development
+
+This repo uses **pnpm** with a committed lockfile and supply-chain controls (see [SECURITY.md](SECURITY.md)). Development requires **Node.js 22+** (transitive `isolated-vm` from `n8n-workflow`). After clone:
+
+```bash
+corepack enable && corepack prepare pnpm@10.19.0 --activate
+pnpm install --frozen-lockfile
+pnpm run audit:supply-chain
+pnpm run build
+```
+
 ## Installation
 
 Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
@@ -34,66 +45,99 @@ npm install n8n-nodes-halopsacomplete
 3. **Client Secret**: OAuth 2.0 Client Secret from HaloPSA
 4. **Scope**: OAuth 2.0 scope (default: "all" for full API access)
 
-## Supported Operations
-
-### Triggers
-
-#### HaloPSA Trigger
-Receive real-time webhook notifications from HaloPSA for ticket events:
-- **New Ticket Logged** - Triggered when a new ticket is created
-- **Ticket Updated by User** - Triggered when a user updates a ticket
-- **Closed** - Triggered when a ticket is closed
-- **1st SLA Warning** - Triggered on first SLA breach warning
-- **2nd SLA Warning** - Triggered on second SLA breach warning
-- **Ticket Deadline** - Triggered when a ticket reaches its deadline
-- **Ticket Status Changed** - Triggered when ticket status changes
-- **Ticket Deleted** - Triggered when a ticket is deleted
-
-The trigger automatically creates and manages webhooks in HaloPSA, handling subscription and cleanup.
+### Dynamic filters and options (expressions)
 
-### Actions
+Operations that support **Filters** also expose **Filters (JSON)** for runtime values (e.g. `{"client_id": {{ $json.client_id }}}`). JSON keys override the same keys from the UI Filters collection.
 
-#### [Agents](./docs/agents.md)
-Manage agent records with extensive filtering options for departments, teams, roles, and permissions.
+**Get by ID** on Tickets, Users, Assets, Projects, and Ticket Statuses also support **Options (JSON)** with the same override behavior.
 
-### [Assets](./docs/assets.md)
-Complete asset management with CRUD operations, comprehensive filtering, and integration support across multiple platforms.
+Use the JSON fields when driving values from webhooks, upstream nodes, or expressions; use the UI collections for static values.
 
-### [Clients](./docs/clients.md) 
-Manage client records including creation, updates, and retrieval with enhanced custom fields support.
+**Return All** on list operations paginates through the HaloPSA API automatically (1000 rows per page).
 
-### [Field Info](./docs/field-info.md)
-Manage custom field definitions and metadata with CRUD operations and enhanced multi-select integration across resources.
-
-### [Invoices](./docs/invoices.md)
-Comprehensive invoice management with CRUD operations, line item updates, and voiding capabilities.
-
-### [Sites](./docs/sites.md)
-Complete site management with full CRUD operations, extensive configuration options, and comprehensive client integration.
-
-### [Ticket Statuses](./docs/ticket-statuses.md)
-Manage ticket status configurations and workflows.
-
-### [Ticket Types](./docs/ticket-types.md)
-Configure and manage ticket type definitions.
-
-### [Tickets](./docs/tickets.md)
-Complete CRUD operations for HaloPSA tickets with comprehensive filtering options.
-
-### [Users](./docs/users.md)
-Comprehensive user management with full CRUD operations, extensive filtering options, and advanced configuration including security roles, site associations, and custom field support.
+## Supported Operations
 
-### [Timesheet](./docs/timesheet.md)
-Track work hours with timesheet management including creation, updates, and time tracking.
+### Triggers
 
-### [Timesheet Events](./docs/timesheet-event.md)
-Manage individual timesheet events and time entries within timesheets.
+#### HaloPSA Trigger
 
-### [Webhooks](./docs/webhooks.md)
-Manage webhooks and automation runbooks with full CRUD operations and comprehensive configuration options.
+Receive real-time webhook notifications from HaloPSA for ticket events:
 
-### [Webhook Events](./docs/webhookEvents.md)
-Manage webhook events that define the types of activities that can trigger webhook notifications.
+- **New Ticket Logged** — New ticket created
+- **Ticket Updated by User** — User updated a ticket
+- **Closed** — Ticket closed
+- **1st SLA Warning** / **2nd SLA Warning** — SLA breach warnings
+- **Ticket Deadline** — Ticket reached its deadline
+- **Ticket Status Changed** — Status changed
+- **Ticket Deleted** — Ticket deleted
+
+The trigger creates and manages webhooks in HaloPSA (subscription and cleanup).
+
+### Resources (actions)
+
+| Resource | Documentation |
+|----------|----------------|
+| Action (ticket actions / notes) | [actions.md](./docs/actions.md) |
+| Agent | [agents.md](./docs/agents.md) |
+| Appointment | [appointments.md](./docs/appointments.md) |
+| Approval Process | [approval-processes.md](./docs/approval-processes.md) |
+| Approval Process Rule | [approval-process-rules.md](./docs/approval-process-rules.md) |
+| Asset | [assets.md](./docs/assets.md) |
+| Attachment | [attachments.md](./docs/attachments.md) |
+| Automation | [automations.md](./docs/automations.md) |
+| Canned Text | [canned-text.md](./docs/canned-text.md) |
+| Category | [categories.md](./docs/categories.md) |
+| Client | [clients.md](./docs/clients.md) |
+| Contract | [contracts.md](./docs/contracts.md) |
+| Contract Rule | [contract-rules.md](./docs/contract-rules.md) |
+| Contract Schedule | [contract-schedules.md](./docs/contract-schedules.md) |
+| Contract Schedule Plan | [contract-schedule-plans.md](./docs/contract-schedule-plans.md) |
+| Custom API Call | [custom-api.md](./docs/custom-api.md) |
+| Feed | [feed.md](./docs/feed.md) |
+| Field Info | [field-info.md](./docs/field-info.md) |
+| Holiday | [holidays.md](./docs/holidays.md) |
+| Invoice | [invoices.md](./docs/invoices.md) |
+| Invoice Payment | [invoice-payments.md](./docs/invoice-payments.md) |
+| Item | [items.md](./docs/items.md) |
+| Notification | [notifications.md](./docs/notifications.md) |
+| Knowledge Base | [knowledge-base.md](./docs/knowledge-base.md) |
+| Lookup | [lookups.md](./docs/lookups.md) |
+| Opportunity | [opportunities.md](./docs/opportunities.md) |
+| Outcome | [outcomes.md](./docs/outcomes.md) |
+| Product Branch | [product-branches.md](./docs/product-branches.md) |
+| Product Component | [product-components.md](./docs/product-components.md) |
+| Project | [projects.md](./docs/projects.md) |
+| Purchase Order | [purchase-orders.md](./docs/purchase-orders.md) |
+| Quotation | [quotations.md](./docs/quotations.md) |
+| Raynet | [raynet.md](./docs/raynet.md) |
+| Raynet Details | [raynet-details.md](./docs/raynet-details.md) |
+| Recurring Invoice | [recurring-invoices.md](./docs/recurring-invoices.md) |
+| Release | [releases.md](./docs/releases.md) |
+| Release Note Group | [release-note-groups.md](./docs/release-note-groups.md) |
+| Reporting | [reporting.md](./docs/reporting.md) |
+| Sales Order | [sales-orders.md](./docs/sales-orders.md) |
+| Secure Secret Link | [secure-secret-links.md](./docs/secure-secret-links.md) |
+| Security Check | [security-checks.md](./docs/security-checks.md) |
+| Site | [sites.md](./docs/sites.md) |
+| Supplier | [suppliers.md](./docs/suppliers.md) |
+| Survey | [surveys.md](./docs/surveys.md) |
+| Tag | [tags.md](./docs/tags.md) |
+| Team | [teams.md](./docs/teams.md) |
+| Top Level | [top-levels.md](./docs/top-levels.md) |
+| Transcription | [transcription-store.md](./docs/transcription-store.md) |
+| Ticket | [tickets.md](./docs/tickets.md) |
+| Ticket Approval | [ticket-approvals.md](./docs/ticket-approvals.md) |
+| Ticket To-Do | [ticket-todos.md](./docs/ticket-todos.md) |
+| To-Do Group | [todo-groups.md](./docs/todo-groups.md) |
+| Ticket Status | [ticket-statuses.md](./docs/ticket-statuses.md) |
+| Ticket Type | [ticket-types.md](./docs/ticket-types.md) |
+| Timesheet | [timesheet.md](./docs/timesheet.md) |
+| Timesheet Event | [timesheet-event.md](./docs/timesheet-event.md) |
+| User | [users.md](./docs/users.md) |
+| Webhook | [webhooks.md](./docs/webhooks.md) |
+| Webhook Event | [webhookEvents.md](./docs/webhookEvents.md) |
+
+API paths not listed above can be called with **Custom API Call**. [`swagger.json`](./swagger.json) at the repo root is the OpenAPI reference for discovering endpoints and payloads.
 
 ## Resources
 
@@ -104,4 +148,3 @@ Manage webhook events that define the types of activities that can trigger webho
 ## License
 
 MIT
-

package/dist/nodes/HaloPSA/HaloPsa.node.d.ts

@@ -14,6 +14,8 @@ export declare class HaloPsa implements INodeType {
             getSites: (this: ILoadOptionsFunctions) => Promise<INodePropertyOptions[]>;
             getClientUsers: (this: ILoadOptionsFunctions) => Promise<INodePropertyOptions[]>;
             getTeams: (this: ILoadOptionsFunctions) => Promise<INodePropertyOptions[]>;
+            getOutcomes: (this: ILoadOptionsFunctions) => Promise<INodePropertyOptions[]>;
+            getReports: (this: ILoadOptionsFunctions) => Promise<INodePropertyOptions[]>;
             getDepartments: (this: ILoadOptionsFunctions) => Promise<INodePropertyOptions[]>;
         };
     };

package/dist/nodes/HaloPSA/HaloPsa.node.js

@@ -36,20 +36,64 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HaloPsa = void 0;
 const actions = __importStar(require("./actions/actions"));
 const agents = __importStar(require("./actions/agents"));
+const appointments = __importStar(require("./actions/appointments"));
+const approvalProcesses = __importStar(require("./actions/approvalProcesses"));
+const approvalProcessRules = __importStar(require("./actions/approvalProcessRules"));
+const categories = __importStar(require("./actions/categories"));
+const attachments = __importStar(require("./actions/attachments"));
+const ticketApprovals = __importStar(require("./actions/ticketApprovals"));
+const ticketTodos = __importStar(require("./actions/ticketTodos"));
+const todoGroups = __importStar(require("./actions/todoGroups"));
 const tickets = __importStar(require("./actions/tickets"));
 const projects = __importStar(require("./actions/projects"));
+const quotations = __importStar(require("./actions/quotations"));
+const salesOrders = __importStar(require("./actions/salesOrders"));
+const recurringInvoices = __importStar(require("./actions/recurringInvoices"));
+const releases = __importStar(require("./actions/releases"));
+const automations = __importStar(require("./actions/automations"));
 const assets = __importStar(require("./actions/assets"));
 const sites = __importStar(require("./actions/sites"));
+const suppliers = __importStar(require("./actions/suppliers"));
 const client = __importStar(require("./actions/client"));
+const cannedText = __importStar(require("./actions/cannedText"));
+const contractRules = __importStar(require("./actions/contractRules"));
+const contractSchedulePlans = __importStar(require("./actions/contractSchedulePlans"));
+const contractSchedules = __importStar(require("./actions/contractSchedules"));
+const contracts = __importStar(require("./actions/contracts"));
+const secureSecretLinks = __importStar(require("./actions/secureSecretLinks"));
+const topLevels = __importStar(require("./actions/topLevels"));
+const customApi = __importStar(require("./actions/customApi"));
+const knowledgeBase = __importStar(require("./actions/knowledgeBase"));
+const notifications = __importStar(require("./actions/notifications"));
+const lookups = __importStar(require("./actions/lookups"));
+const opportunities = __importStar(require("./actions/opportunities"));
+const outcomes = __importStar(require("./actions/outcomes"));
+const productBranches = __importStar(require("./actions/productBranches"));
+const productComponents = __importStar(require("./actions/productComponents"));
+const purchaseOrders = __importStar(require("./actions/purchaseOrders"));
+const raynet = __importStar(require("./actions/raynet"));
+const raynetDetails = __importStar(require("./actions/raynetDetails"));
+const securityChecks = __importStar(require("./actions/securityChecks"));
+const releaseNoteGroups = __importStar(require("./actions/releaseNoteGroups"));
 const invoices = __importStar(require("./actions/invoices"));
+const items = __importStar(require("./actions/items"));
 const timesheet = __importStar(require("./actions/timesheet"));
 const timesheetEvent = __importStar(require("./actions/timesheetEvent"));
 const ticketStatuses = __importStar(require("./actions/ticketStatuses"));
 const ticketTypes = __importStar(require("./actions/ticketTypes"));
 const webhooks = __importStar(require("./actions/webhooks"));
 const webhookEvents = __importStar(require("./actions/webhookEvents"));
+const feed = __importStar(require("./actions/feed"));
 const fieldInfo = __importStar(require("./actions/fieldInfo"));
+const holidays = __importStar(require("./actions/holidays"));
+const invoicePayments = __importStar(require("./actions/invoicePayments"));
 const users = __importStar(require("./actions/users"));
+const reporting = __importStar(require("./reporting"));
+const surveys = __importStar(require("./actions/surveys"));
+const tags = __importStar(require("./actions/tags"));
+const teams = __importStar(require("./actions/teams"));
+const transcriptionStore = __importStar(require("./actions/transcriptionStore"));
+const n8n_workflow_1 = require("n8n-workflow");
 class HaloPsa {
     constructor() {
         this.description = {
@@ -64,8 +108,8 @@ class HaloPsa {
             defaults: {
                 name: 'HaloPSA Complete',
             },
-            inputs: ["main"],
-            outputs: ["main"],
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
             credentials: [
                 {
                     name: 'haloPSACompleteApiOAuth2OAuth2Api',
@@ -87,38 +131,198 @@ class HaloPsa {
                             name: 'Agent',
                             value: 'agents',
                         },
+                        {
+                            name: 'Appointment',
+                            value: 'appointments',
+                        },
+                        {
+                            name: 'Approval Process',
+                            value: 'approvalProcesses',
+                        },
+                        {
+                            name: 'Approval Process Rule',
+                            value: 'approvalProcessRules',
+                        },
                         {
                             name: 'Asset',
                             value: 'assets',
                         },
+                        {
+                            name: 'Attachment',
+                            value: 'attachments',
+                        },
+                        {
+                            name: 'Automation',
+                            value: 'automations',
+                        },
+                        {
+                            name: 'Canned Text',
+                            value: 'cannedText',
+                        },
+                        {
+                            name: 'Category',
+                            value: 'categories',
+                        },
                         {
                             name: 'Client',
                             value: 'client',
                         },
+                        {
+                            name: 'Contract',
+                            value: 'contracts',
+                        },
+                        {
+                            name: 'Contract Rule',
+                            value: 'contractRules',
+                        },
+                        {
+                            name: 'Contract Schedule',
+                            value: 'contractSchedules',
+                        },
+                        {
+                            name: 'Contract Schedule Plan',
+                            value: 'contractSchedulePlans',
+                        },
+                        {
+                            name: 'Custom API Call',
+                            value: 'customApi',
+                        },
+                        {
+                            name: 'Feed',
+                            value: 'feed',
+                        },
                         {
                             name: 'Field Info',
                             value: 'fieldInfo',
                         },
+                        {
+                            name: 'Holiday',
+                            value: 'holidays',
+                        },
                         {
                             name: 'Invoice',
                             value: 'invoices',
                         },
+                        {
+                            name: 'Invoice Payment',
+                            value: 'invoicePayments',
+                        },
+                        {
+                            name: 'Item',
+                            value: 'items',
+                        },
+                        {
+                            name: 'Knowledge Base',
+                            value: 'knowledgeBase',
+                        },
+                        {
+                            name: 'Lookup',
+                            value: 'lookups',
+                        },
+                        {
+                            name: 'Notification',
+                            value: 'notifications',
+                        },
+                        {
+                            name: 'Opportunity',
+                            value: 'opportunities',
+                        },
+                        {
+                            name: 'Outcome',
+                            value: 'outcomes',
+                        },
+                        {
+                            name: 'Product Branch',
+                            value: 'productBranches',
+                        },
+                        {
+                            name: 'Product Component',
+                            value: 'productComponents',
+                        },
                         {
                             name: 'Project',
                             value: 'projects',
                         },
+                        {
+                            name: 'Purchase Order',
+                            value: 'purchaseOrders',
+                        },
+                        {
+                            name: 'Quotation',
+                            value: 'quotations',
+                        },
+                        {
+                            name: 'Raynet',
+                            value: 'raynet',
+                        },
+                        {
+                            name: 'Raynet Detail',
+                            value: 'raynetDetails',
+                        },
+                        {
+                            name: 'Recurring Invoice',
+                            value: 'recurringInvoices',
+                        },
+                        {
+                            name: 'Release',
+                            value: 'releases',
+                        },
+                        {
+                            name: 'Release Note Group',
+                            value: 'releaseNoteGroups',
+                        },
+                        {
+                            name: 'Reporting',
+                            value: 'reporting',
+                        },
+                        {
+                            name: 'Sales Order',
+                            value: 'salesOrders',
+                        },
+                        {
+                            name: 'Secure Secret Link',
+                            value: 'secureSecretLinks',
+                        },
+                        {
+                            name: 'Security Check',
+                            value: 'securityChecks',
+                        },
                         {
                             name: 'Site',
                             value: 'sites',
                         },
+                        {
+                            name: 'Supplier',
+                            value: 'suppliers',
+                        },
+                        {
+                            name: 'Survey',
+                            value: 'surveys',
+                        },
+                        {
+                            name: 'Tag',
+                            value: 'tags',
+                        },
+                        {
+                            name: 'Team',
+                            value: 'teams',
+                        },
                         {
                             name: 'Ticket',
                             value: 'tickets',
                         },
+                        {
+                            name: 'Ticket Approval',
+                            value: 'ticketApprovals',
+                        },
                         {
                             name: 'Ticket Status',
                             value: 'ticketStatuses',
                         },
+                        {
+                            name: 'Ticket To-Do',
+                            value: 'ticketTodos',
+                        },
                         {
                             name: 'Ticket Type',
                             value: 'ticketTypes',
@@ -131,6 +335,14 @@ class HaloPsa {
                             name: 'Timesheet Event',
                             value: 'timesheetEvent',
                         },
+                        {
+                            name: 'Top Level',
+                            value: 'topLevels',
+                        },
+                        {
+                            name: 'Transcription',
+                            value: 'transcriptionStore',
+                        },
                         {
                             name: 'User',
                             value: 'users',
@@ -148,20 +360,63 @@ class HaloPsa {
                 },
                 ...actions.description,
                 ...agents.description,
-                ...tickets.description,
-                ...projects.description,
+                ...appointments.description,
+                ...approvalProcesses.description,
+                ...approvalProcessRules.description,
+                ...attachments.description,
+                ...automations.description,
                 ...assets.description,
-                ...sites.description,
+                ...cannedText.description,
+                ...categories.description,
                 ...client.description,
+                ...contracts.description,
+                ...contractRules.description,
+                ...contractSchedules.description,
+                ...contractSchedulePlans.description,
+                ...customApi.description,
+                ...feed.description,
+                ...fieldInfo.description,
+                ...holidays.description,
+                ...invoicePayments.description,
                 ...invoices.description,
-                ...timesheet.description,
-                ...timesheetEvent.description,
+                ...items.description,
+                ...notifications.description,
+                ...knowledgeBase.description,
+                ...lookups.description,
+                ...opportunities.description,
+                ...outcomes.description,
+                ...productBranches.description,
+                ...productComponents.description,
+                ...projects.description,
+                ...purchaseOrders.description,
+                ...quotations.description,
+                ...raynet.description,
+                ...raynetDetails.description,
+                ...recurringInvoices.description,
+                ...releases.description,
+                ...releaseNoteGroups.description,
+                ...reporting.description,
+                ...salesOrders.description,
+                ...secureSecretLinks.description,
+                ...securityChecks.description,
+                ...sites.description,
+                ...suppliers.description,
+                ...surveys.description,
+                ...tags.description,
+                ...teams.description,
+                ...topLevels.description,
+                ...transcriptionStore.description,
+                ...ticketApprovals.description,
+                ...ticketTodos.description,
+                ...todoGroups.description,
                 ...ticketStatuses.description,
                 ...ticketTypes.description,
+                ...tickets.description,
+                ...timesheet.description,
+                ...timesheetEvent.description,
+                ...users.description,
                 ...webhooks.description,
                 ...webhookEvents.description,
-                ...fieldInfo.description,
-                ...users.description,
             ],
         };
         this.methods = {
@@ -484,7 +739,7 @@ class HaloPsa {
                     const { apiRequest } = await Promise.resolve().then(() => __importStar(require('./transport')));
                     try {
                         const requestMethod = 'GET';
-                        const endpoint = '/team';
+                        const endpoint = '/Team';
                         const body = {};
                         const qs = {
                             showall: true,
@@ -509,6 +764,49 @@ class HaloPsa {
                         return [];
                     }
                 },
+                getOutcomes: async function () {
+                    const { apiRequest } = await Promise.resolve().then(() => __importStar(require('./transport')));
+                    try {
+                        const responseData = await apiRequest.call(this, 'GET', '/Outcome', {}, {});
+                        const outcomes = Array.isArray(responseData) ? responseData : [];
+                        const options = [];
+                        for (const outcome of outcomes) {
+                            if ((outcome === null || outcome === void 0 ? void 0 : outcome.id) != null) {
+                                options.push({
+                                    name: outcome.name || `Outcome ${outcome.id}`,
+                                    value: outcome.id,
+                                });
+                            }
+                        }
+                        return options.sort((a, b) => a.name.localeCompare(b.name));
+                    }
+                    catch {
+                        return [];
+                    }
+                },
+                getReports: async function () {
+                    const { apiRequest } = await Promise.resolve().then(() => __importStar(require('./transport')));
+                    try {
+                        const responseData = await apiRequest.call(this, 'GET', '/Report', {}, { count: 100 });
+                        const reports = Array.isArray(responseData) ? responseData : [responseData];
+                        const options = [];
+                        for (const report of reports) {
+                            if (report === null || report === void 0 ? void 0 : report.id) {
+                                const name = report.name ||
+                                    report.reportname ||
+                                    `Report ${report.id}`;
+                                options.push({
+                                    name,
+                                    value: report.id.toString(),
+                                });
+                            }
+                        }
+                        return options.sort((a, b) => a.name.localeCompare(b.name));
+                    }
+                    catch {
+                        return [];
+                    }
+                },
                 getDepartments: async function () {
                     const { apiRequest } = await Promise.resolve().then(() => __importStar(require('./transport')));
                     try {