@thegraphitelab/n8n-nodes-servicetitan 0.3.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/credentials/ServiceTitanApi.credentials.js +5 -1
- package/dist/credentials/ServiceTitanApi.credentials.js.map +1 -1
- package/dist/nodes/ServiceTitan/GenericFunctions.d.ts +7 -0
- package/dist/nodes/ServiceTitan/GenericFunctions.js +28 -0
- package/dist/nodes/ServiceTitan/GenericFunctions.js.map +1 -0
- package/dist/nodes/ServiceTitan/ServiceTitanTrigger.node.d.ts +5 -0
- package/dist/nodes/ServiceTitan/ServiceTitanTrigger.node.js +179 -0
- package/dist/nodes/ServiceTitan/ServiceTitanTrigger.node.js.map +1 -0
- package/dist/nodes/ServiceTitan/ServiceTitanTrigger.node.json +18 -0
- package/dist/package.json +3 -2
- package/package.json +3 -2
|
@@ -61,11 +61,15 @@ class ServiceTitanApi {
|
|
|
61
61
|
},
|
|
62
62
|
// Both fields below are populated by preAuthentication, not user input.
|
|
63
63
|
// appKey is read from the TGL_SERVICETITAN_APP_KEY env var on the n8n service.
|
|
64
|
+
// `expirable: true` on accessToken is REQUIRED — n8n's credentials-helper
|
|
65
|
+
// short-circuits and never invokes preAuthentication unless at least one
|
|
66
|
+
// hidden property has expirable:true. Without it, both fields stay '' and
|
|
67
|
+
// the ST-App-Key header goes out empty → 401 from ServiceTitan.
|
|
64
68
|
{
|
|
65
69
|
displayName: 'Access Token',
|
|
66
70
|
name: 'accessToken',
|
|
67
71
|
type: 'hidden',
|
|
68
|
-
typeOptions: { password: true },
|
|
72
|
+
typeOptions: { password: true, expirable: true },
|
|
69
73
|
default: '',
|
|
70
74
|
},
|
|
71
75
|
{
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ServiceTitanApi.credentials.js","sourceRoot":"","sources":["../../credentials/ServiceTitanApi.credentials.ts"],"names":[],"mappings":";;;AAoBA,gCAIC;AAfD;;;;GAIG;AACH,SAAS,WAAW,CAAC,WAAmB;IACvC,OAAO,WAAW,KAAK,YAAY;QAClC,CAAC,CAAC,sBAAsB;QACxB,CAAC,CAAC,kCAAkC,CAAC;AACvC,CAAC;AAED,SAAgB,UAAU,CAAC,WAAmB;IAC7C,OAAO,WAAW,KAAK,YAAY;QAClC,CAAC,CAAC,qBAAqB;QACvB,CAAC,CAAC,iCAAiC,CAAC;AACtC,CAAC;AAED,MAAa,eAAe;IAC3B,IAAI,GAAG,iBAAiB,CAAC;IAEzB,WAAW,GAAG,kBAAkB,CAAC;IAEjC,IAAI,GAAG,6CAAsD,CAAC;IAE9D,gBAAgB,GAAG,oCAAoC,CAAC;IAExD,UAAU,GAAsB;QAC/B;YACC,WAAW,EAAE,aAAa;YAC1B,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE;gBACR,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,aAAa,EAAE;gBACvD,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;aAC3C;YACD,OAAO,EAAE,aAAa;YACtB,WAAW,EACV,yJAAyJ;SAC1J;QACD;YACC,WAAW,EAAE,WAAW;YACxB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EACV,8FAA8F;SAC/F;QACD;YACC,WAAW,EAAE,WAAW;YACxB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,mFAAmF;SAChG;QACD;YACC,WAAW,EAAE,eAAe;YAC5B,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC/B,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,uFAAuF;SACpG;QACD,wEAAwE;QACxE,+EAA+E;QAC/E;YACC,WAAW,EAAE,cAAc;YAC3B,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;
|
|
1
|
+
{"version":3,"file":"ServiceTitanApi.credentials.js","sourceRoot":"","sources":["../../credentials/ServiceTitanApi.credentials.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { IDataObject, IExecuteFunctions, IHttpRequestMethods, ILoadOptionsFunctions, IPollFunctions } from 'n8n-workflow';
|
|
2
|
+
/**
|
|
3
|
+
* Shared ServiceTitan API request helper. Routes through n8n's auth helper so
|
|
4
|
+
* the ServiceTitanApi credential's preAuthentication (token refresh + ST-App-Key
|
|
5
|
+
* injection from TGL_SERVICETITAN_APP_KEY) runs on every call.
|
|
6
|
+
*/
|
|
7
|
+
export declare function serviceTitanApiRequest(this: IExecuteFunctions | IPollFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, path: string, qs?: IDataObject, body?: IDataObject | undefined): Promise<IDataObject>;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.serviceTitanApiRequest = serviceTitanApiRequest;
|
|
4
|
+
const ServiceTitanApi_credentials_1 = require("../../credentials/ServiceTitanApi.credentials");
|
|
5
|
+
/**
|
|
6
|
+
* Shared ServiceTitan API request helper. Routes through n8n's auth helper so
|
|
7
|
+
* the ServiceTitanApi credential's preAuthentication (token refresh + ST-App-Key
|
|
8
|
+
* injection from TGL_SERVICETITAN_APP_KEY) runs on every call.
|
|
9
|
+
*/
|
|
10
|
+
async function serviceTitanApiRequest(method, path, qs = {}, body = undefined) {
|
|
11
|
+
const credentials = await this.getCredentials('serviceTitanApi');
|
|
12
|
+
const environment = credentials.environment ?? 'integration';
|
|
13
|
+
const apiHost = (0, ServiceTitanApi_credentials_1.getApiHost)(environment);
|
|
14
|
+
const options = {
|
|
15
|
+
method,
|
|
16
|
+
url: `https://${apiHost}${path}`,
|
|
17
|
+
qs,
|
|
18
|
+
headers: {
|
|
19
|
+
Accept: 'application/json',
|
|
20
|
+
'Content-Type': 'application/json',
|
|
21
|
+
},
|
|
22
|
+
json: true,
|
|
23
|
+
};
|
|
24
|
+
if (body !== undefined)
|
|
25
|
+
options.body = body;
|
|
26
|
+
return (await this.helpers.httpRequestWithAuthentication.call(this, 'serviceTitanApi', options));
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=GenericFunctions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"GenericFunctions.js","sourceRoot":"","sources":["../../../nodes/ServiceTitan/GenericFunctions.ts"],"names":[],"mappings":";;AAgBA,wDA4BC;AAnCD,+FAA2E;AAE3E;;;;GAIG;AACI,KAAK,UAAU,sBAAsB,CAE3C,MAA2B,EAC3B,IAAY,EACZ,KAAkB,EAAE,EACpB,OAAgC,SAAS;IAEzC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACjE,MAAM,WAAW,GAAI,WAAW,CAAC,WAAsB,IAAI,aAAa,CAAC;IACzE,MAAM,OAAO,GAAG,IAAA,wCAAU,EAAC,WAAW,CAAC,CAAC;IAExC,MAAM,OAAO,GAAwB;QACpC,MAAM;QACN,GAAG,EAAE,WAAW,OAAO,GAAG,IAAI,EAAE;QAChC,EAAE;QACF,OAAO,EAAE;YACR,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,kBAAkB;SAClC;QACD,IAAI,EAAE,IAAI;KACV,CAAC;IACF,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAE5C,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,IAAI,CAC5D,IAAI,EACJ,iBAAiB,EACjB,OAAO,CACP,CAAgB,CAAC;AACnB,CAAC"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import { type INodeExecutionData, type INodeType, type INodeTypeDescription, type IPollFunctions } from 'n8n-workflow';
|
|
2
|
+
export declare class ServiceTitanTrigger implements INodeType {
|
|
3
|
+
description: INodeTypeDescription;
|
|
4
|
+
poll(this: IPollFunctions): Promise<INodeExecutionData[][] | null>;
|
|
5
|
+
}
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ServiceTitanTrigger = void 0;
|
|
4
|
+
const n8n_workflow_1 = require("n8n-workflow");
|
|
5
|
+
const GenericFunctions_1 = require("./GenericFunctions");
|
|
6
|
+
const JOB_STATUSES = ['Scheduled', 'InProgress', 'Hold', 'Completed', 'Canceled'];
|
|
7
|
+
class ServiceTitanTrigger {
|
|
8
|
+
description = {
|
|
9
|
+
displayName: 'ServiceTitan Trigger',
|
|
10
|
+
name: 'serviceTitanTrigger',
|
|
11
|
+
icon: {
|
|
12
|
+
light: 'file:servicetitan.svg',
|
|
13
|
+
dark: 'file:servicetitan.dark.svg',
|
|
14
|
+
},
|
|
15
|
+
group: ['trigger'],
|
|
16
|
+
version: 1,
|
|
17
|
+
description: 'Starts the workflow when ServiceTitan records are created or modified',
|
|
18
|
+
subtitle: '={{$parameter.event}}',
|
|
19
|
+
defaults: {
|
|
20
|
+
name: 'ServiceTitan Trigger',
|
|
21
|
+
},
|
|
22
|
+
polling: true,
|
|
23
|
+
usableAsTool: true,
|
|
24
|
+
inputs: [],
|
|
25
|
+
outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
|
|
26
|
+
credentials: [
|
|
27
|
+
{
|
|
28
|
+
name: 'serviceTitanApi',
|
|
29
|
+
required: true,
|
|
30
|
+
},
|
|
31
|
+
],
|
|
32
|
+
properties: [
|
|
33
|
+
{
|
|
34
|
+
displayName: 'Trigger On',
|
|
35
|
+
name: 'event',
|
|
36
|
+
type: 'options',
|
|
37
|
+
noDataExpression: true,
|
|
38
|
+
default: 'jobCreatedOrModified',
|
|
39
|
+
options: [
|
|
40
|
+
{
|
|
41
|
+
name: 'Job Created or Modified',
|
|
42
|
+
value: 'jobCreatedOrModified',
|
|
43
|
+
description: 'Fires for any job whose modifiedOn timestamp has advanced since the last poll',
|
|
44
|
+
},
|
|
45
|
+
],
|
|
46
|
+
description: 'ServiceTitan updates modifiedOn for any field change including internal status churn, so expect more fires than human-meaningful changes — filter downstream',
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
displayName: 'Filters',
|
|
50
|
+
name: 'filters',
|
|
51
|
+
type: 'collection',
|
|
52
|
+
placeholder: 'Add Filter',
|
|
53
|
+
default: {},
|
|
54
|
+
displayOptions: { show: { event: ['jobCreatedOrModified'] } },
|
|
55
|
+
options: [
|
|
56
|
+
{
|
|
57
|
+
displayName: 'Business Unit ID',
|
|
58
|
+
name: 'businessUnitId',
|
|
59
|
+
type: 'string',
|
|
60
|
+
default: '',
|
|
61
|
+
description: 'Only emit jobs from this business unit',
|
|
62
|
+
},
|
|
63
|
+
{
|
|
64
|
+
displayName: 'Customer ID',
|
|
65
|
+
name: 'customerId',
|
|
66
|
+
type: 'string',
|
|
67
|
+
default: '',
|
|
68
|
+
},
|
|
69
|
+
{
|
|
70
|
+
displayName: 'Include Inactive (Soft-Deleted)',
|
|
71
|
+
name: 'includeInactive',
|
|
72
|
+
type: 'boolean',
|
|
73
|
+
default: false,
|
|
74
|
+
description: 'Whether to include soft-deleted jobs. ServiceTitan bumps modifiedOn on deletion, so leaving this off (default) is the right call for most sync workflows.',
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
displayName: 'Job Status',
|
|
78
|
+
name: 'jobStatus',
|
|
79
|
+
type: 'multiOptions',
|
|
80
|
+
default: [],
|
|
81
|
+
options: JOB_STATUSES.map((s) => ({ name: s, value: s })),
|
|
82
|
+
description: 'Only emit jobs with one of these statuses',
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
displayName: 'Job Type ID',
|
|
86
|
+
name: 'jobTypeId',
|
|
87
|
+
type: 'string',
|
|
88
|
+
default: '',
|
|
89
|
+
},
|
|
90
|
+
],
|
|
91
|
+
},
|
|
92
|
+
],
|
|
93
|
+
};
|
|
94
|
+
async poll() {
|
|
95
|
+
const credentials = await this.getCredentials('serviceTitanApi');
|
|
96
|
+
const tenantId = credentials.tenantId;
|
|
97
|
+
const staticData = this.getWorkflowStaticData('node');
|
|
98
|
+
// If the underlying tenant changed (credential swap), wipe the cursor.
|
|
99
|
+
if (staticData.tenantId && staticData.tenantId !== tenantId) {
|
|
100
|
+
delete staticData.lastTimeChecked;
|
|
101
|
+
delete staticData.boundaryIds;
|
|
102
|
+
}
|
|
103
|
+
staticData.tenantId = tenantId;
|
|
104
|
+
const now = new Date().toISOString();
|
|
105
|
+
// First run: start the watermark at activation time so we don't drain ST history.
|
|
106
|
+
const since = staticData.lastTimeChecked ?? now;
|
|
107
|
+
const boundaryIds = new Set(staticData.boundaryIds ?? []);
|
|
108
|
+
const event = this.getNodeParameter('event', 0);
|
|
109
|
+
if (event !== 'jobCreatedOrModified') {
|
|
110
|
+
return null;
|
|
111
|
+
}
|
|
112
|
+
const filters = this.getNodeParameter('filters', 0, {});
|
|
113
|
+
const baseQs = {
|
|
114
|
+
modifiedOnOrAfter: since,
|
|
115
|
+
modifiedBefore: now,
|
|
116
|
+
sort: '+ModifiedOn',
|
|
117
|
+
pageSize: 100,
|
|
118
|
+
includeTotal: false,
|
|
119
|
+
active: filters.includeInactive ? 'Any' : 'True',
|
|
120
|
+
};
|
|
121
|
+
if (filters.jobStatus && filters.jobStatus.length > 0) {
|
|
122
|
+
baseQs.jobStatus = filters.jobStatus[0];
|
|
123
|
+
}
|
|
124
|
+
if (filters.businessUnitId)
|
|
125
|
+
baseQs.businessUnitId = filters.businessUnitId;
|
|
126
|
+
if (filters.jobTypeId)
|
|
127
|
+
baseQs.jobTypeId = filters.jobTypeId;
|
|
128
|
+
if (filters.customerId)
|
|
129
|
+
baseQs.customerId = filters.customerId;
|
|
130
|
+
const collected = [];
|
|
131
|
+
let page = 1;
|
|
132
|
+
const maxPages = 50;
|
|
133
|
+
try {
|
|
134
|
+
while (page <= maxPages) {
|
|
135
|
+
const response = (await GenericFunctions_1.serviceTitanApiRequest.call(this, 'GET', `/jpm/v2/tenant/${tenantId}/jobs`, { ...baseQs, page }));
|
|
136
|
+
const rows = Array.isArray(response.data) ? response.data : [];
|
|
137
|
+
for (const job of rows) {
|
|
138
|
+
const id = Number(job.id);
|
|
139
|
+
if (Number.isFinite(id) && boundaryIds.has(id))
|
|
140
|
+
continue;
|
|
141
|
+
collected.push(job);
|
|
142
|
+
}
|
|
143
|
+
if (!response.hasMore)
|
|
144
|
+
break;
|
|
145
|
+
page += 1;
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
catch (error) {
|
|
149
|
+
// Bubble up so n8n's poll runner logs it and retries next tick. We do NOT
|
|
150
|
+
// advance staticData here — same window will be re-polled.
|
|
151
|
+
throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
|
|
152
|
+
}
|
|
153
|
+
// Manual ("Fetch Test Event") mode: return one sample without burning the
|
|
154
|
+
// watermark, so users can wire downstream nodes safely.
|
|
155
|
+
if (this.getMode() === 'manual') {
|
|
156
|
+
if (collected.length === 0)
|
|
157
|
+
return null;
|
|
158
|
+
return [this.helpers.returnJsonArray(collected.slice(0, 1))];
|
|
159
|
+
}
|
|
160
|
+
// Advance cursor only on success.
|
|
161
|
+
staticData.lastTimeChecked = now;
|
|
162
|
+
// Boundary-id Set: ids of any returned job whose modifiedOn equals the new
|
|
163
|
+
// cursor, so the next poll's inclusive modifiedOnOrAfter doesn't duplicate-fire.
|
|
164
|
+
const newBoundary = [];
|
|
165
|
+
for (const job of collected) {
|
|
166
|
+
if (typeof job.modifiedOn === 'string' && job.modifiedOn === now) {
|
|
167
|
+
const id = Number(job.id);
|
|
168
|
+
if (Number.isFinite(id))
|
|
169
|
+
newBoundary.push(id);
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
staticData.boundaryIds = newBoundary;
|
|
173
|
+
if (collected.length === 0)
|
|
174
|
+
return null;
|
|
175
|
+
return [this.helpers.returnJsonArray(collected)];
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
exports.ServiceTitanTrigger = ServiceTitanTrigger;
|
|
179
|
+
//# sourceMappingURL=ServiceTitanTrigger.node.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ServiceTitanTrigger.node.js","sourceRoot":"","sources":["../../../nodes/ServiceTitan/ServiceTitanTrigger.node.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"node": "n8n-nodes-base.serviceTitanTrigger",
|
|
3
|
+
"nodeVersion": "1.0",
|
|
4
|
+
"codexVersion": "1.0",
|
|
5
|
+
"categories": ["Sales", "Productivity"],
|
|
6
|
+
"resources": {
|
|
7
|
+
"primaryDocumentation": [
|
|
8
|
+
{
|
|
9
|
+
"url": "https://github.com/thegraphitelab/tgl-custom-n8n-nodes/blob/main/packages/n8n-nodes-servicetitan/README.md"
|
|
10
|
+
}
|
|
11
|
+
],
|
|
12
|
+
"credentialDocumentation": [
|
|
13
|
+
{
|
|
14
|
+
"url": "https://developer.servicetitan.io/"
|
|
15
|
+
}
|
|
16
|
+
]
|
|
17
|
+
}
|
|
18
|
+
}
|
package/dist/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@thegraphitelab/n8n-nodes-servicetitan",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.0",
|
|
4
4
|
"description": "n8n custom node for ServiceTitan — TGL internal use.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"n8n-community-node-package",
|
|
@@ -44,7 +44,8 @@
|
|
|
44
44
|
"dist/credentials/ServiceTitanApi.credentials.js"
|
|
45
45
|
],
|
|
46
46
|
"nodes": [
|
|
47
|
-
"dist/nodes/ServiceTitan/TglServiceTitan.node.js"
|
|
47
|
+
"dist/nodes/ServiceTitan/TglServiceTitan.node.js",
|
|
48
|
+
"dist/nodes/ServiceTitan/ServiceTitanTrigger.node.js"
|
|
48
49
|
]
|
|
49
50
|
},
|
|
50
51
|
"devDependencies": {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@thegraphitelab/n8n-nodes-servicetitan",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.0",
|
|
4
4
|
"description": "n8n custom node for ServiceTitan — TGL internal use.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"n8n-community-node-package",
|
|
@@ -37,7 +37,8 @@
|
|
|
37
37
|
"dist/credentials/ServiceTitanApi.credentials.js"
|
|
38
38
|
],
|
|
39
39
|
"nodes": [
|
|
40
|
-
"dist/nodes/ServiceTitan/TglServiceTitan.node.js"
|
|
40
|
+
"dist/nodes/ServiceTitan/TglServiceTitan.node.js",
|
|
41
|
+
"dist/nodes/ServiceTitan/ServiceTitanTrigger.node.js"
|
|
41
42
|
]
|
|
42
43
|
},
|
|
43
44
|
"devDependencies": {
|