@thegraphitelab/n8n-nodes-servicetitan 0.9.5 → 0.10.1

package/dist/credentials/ServiceTitanApi.credentials.d.ts

@@ -1,4 +1,4 @@
-import type { IAuthenticateGeneric, ICredentialDataDecryptedObject, ICredentialTestRequest, ICredentialType, IHttpRequestHelper, INodeProperties } from 'n8n-workflow';
+import type { IAuthenticateGeneric, ICredentialDataDecryptedObject, ICredentialTestRequest, ICredentialType, IHttpRequestHelper, INodeProperties } from "n8n-workflow";
 export declare function getApiHost(environment: string): string;
 export declare class ServiceTitanApi implements ICredentialType {
     name: string;

package/dist/credentials/ServiceTitanApi.credentials.js

@@ -2,125 +2,123 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceTitanApi = void 0;
 exports.getApiHost = getApiHost;
+const customAppSecrets_1 = require("./customAppSecrets");
+// Label of the TGL_CUSTOM_APP_SECRETS entry holding the TGL-owned ST-App-Key.
+const SERVICETITAN_APP_KEY_LABEL = "TGL_SERVICETITAN_API_KEY";
 /**
  * ServiceTitan auth hosts by environment.
  * Integration ("Sandbox") and Production are entirely separate ST environments —
  * different app registrations, different tenant IDs, different credentials.
  */
 function getAuthHost(environment) {
-    return environment === 'production'
-        ? 'auth.servicetitan.io'
-        : 'auth-integration.servicetitan.io';
+    return environment === "production"
+        ? "auth.servicetitan.io"
+        : "auth-integration.servicetitan.io";
 }
 function getApiHost(environment) {
-    return environment === 'production'
-        ? 'api.servicetitan.io'
-        : 'api-integration.servicetitan.io';
+    return environment === "production"
+        ? "api.servicetitan.io"
+        : "api-integration.servicetitan.io";
 }
 class ServiceTitanApi {
-    name = 'serviceTitanApi';
-    displayName = 'ServiceTitan API';
-    icon = 'file:../nodes/ServiceTitan/servicetitan.svg';
-    documentationUrl = 'https://developer.servicetitan.io/';
+    name = "serviceTitanApi";
+    displayName = "ServiceTitan API";
+    icon = "file:../nodes/ServiceTitan/servicetitan.svg";
+    documentationUrl = "https://developer.servicetitan.io/";
     properties = [
         {
-            displayName: 'Environment',
-            name: 'environment',
-            type: 'options',
+            displayName: "Environment",
+            name: "environment",
+            type: "options",
             options: [
-                { name: 'Integration (Sandbox)', value: 'integration' },
-                { name: 'Production', value: 'production' },
+                { name: "Integration (Sandbox)", value: "integration" },
+                { name: "Production", value: "production" },
             ],
-            default: 'integration',
-            description: 'Which ServiceTitan environment to connect to. Integration and Production are entirely separate — they need different app registrations and credentials.',
+            default: "integration",
+            description: "Which ServiceTitan environment to connect to. Integration and Production are entirely separate — they need different app registrations and credentials.",
         },
         {
-            displayName: 'Tenant ID',
-            name: 'tenantId',
-            type: 'string',
-            default: '',
+            displayName: "Tenant ID",
+            name: "tenantId",
+            type: "string",
+            default: "",
             required: true,
-            description: 'Found in ServiceTitan → Settings → API Application Access. Treated as a string in URL paths.',
+            description: "Found in ServiceTitan → Settings → API Application Access. Treated as a string in URL paths.",
         },
         {
-            displayName: 'Client ID',
-            name: 'clientId',
-            type: 'string',
-            default: '',
+            displayName: "Client ID",
+            name: "clientId",
+            type: "string",
+            default: "",
             required: true,
             description: "Per-client OAuth client ID from ServiceTitan → Settings → API Application Access.",
         },
         {
-            displayName: 'Client Secret',
-            name: 'clientSecret',
-            type: 'string',
+            displayName: "Client Secret",
+            name: "clientSecret",
+            type: "string",
             typeOptions: { password: true },
-            default: '',
+            default: "",
             required: true,
             description: "Per-client OAuth client secret from ServiceTitan → Settings → API Application Access.",
         },
         // Both fields below are populated by preAuthentication, not user input.
-        // appKey is read from the TGL_SERVICETITAN_APP_KEY env var on the n8n service.
+        // appKey comes from the TGL_CUSTOM_APP_SECRETS array (label
+        // "TGL_SERVICETITAN_API_KEY") on the n8n service.
         // `expirable: true` on accessToken is REQUIRED — n8n's credentials-helper
         // short-circuits and never invokes preAuthentication unless at least one
         // hidden property has expirable:true. Without it, both fields stay '' and
         // the ST-App-Key header goes out empty → 401 from ServiceTitan.
         {
-            displayName: 'Access Token',
-            name: 'accessToken',
-            type: 'hidden',
+            displayName: "Access Token",
+            name: "accessToken",
+            type: "hidden",
             typeOptions: { password: true, expirable: true },
-            default: '',
+            default: "",
         },
         {
-            displayName: 'App Key',
-            name: 'appKey',
-            type: 'hidden',
+            displayName: "App Key",
+            name: "appKey",
+            type: "hidden",
             typeOptions: { password: true },
-            default: '',
+            default: "",
         },
     ];
     async preAuthentication(credentials) {
-        // The ST-App-Key is TGL-owned and identical across all clients, so it
-        // belongs at the n8n instance level, not on every credential.
-        // eslint-disable-next-line @n8n/community-nodes/no-restricted-globals
-        const appKey = process.env.TGL_SERVICETITAN_APP_KEY;
-        if (!appKey) {
-            throw new Error('[ServiceTitan auth] TGL_SERVICETITAN_APP_KEY env var is not set on this n8n service. Set it on BOTH the n8n primary and worker services, then redeploy.');
-        }
-        const environment = credentials.environment ?? 'integration';
+        // The ST-App-Key is TGL-owned and identical across all clients, so it lives
+        // at the n8n instance level in the shared TGL_CUSTOM_APP_SECRETS array
+        // (keyed by label), not on every credential. Throws if unset/missing.
+        const appKey = (0, customAppSecrets_1.getCustomAppSecret)(SERVICETITAN_APP_KEY_LABEL);
+        const environment = credentials.environment ?? "integration";
         const clientId = credentials.clientId;
         const clientSecret = credentials.clientSecret;
         const tenantId = credentials.tenantId;
         const missing = [];
         if (!clientId)
-            missing.push('Client ID');
+            missing.push("Client ID");
         if (!clientSecret)
-            missing.push('Client Secret');
+            missing.push("Client Secret");
         if (!tenantId)
-            missing.push('Tenant ID');
+            missing.push("Tenant ID");
         if (missing.length > 0) {
-            throw new Error(`[ServiceTitan auth] Missing required credential field(s): ${missing.join(', ')}. Fill them in on the n8n credential and save.`);
+            throw new Error(`[ServiceTitan auth] Missing required credential field(s): ${missing.join(", ")}. Fill them in on the n8n credential and save.`);
         }
         const authHost = getAuthHost(environment);
         const tokenUrl = `https://${authHost}/connect/token`;
         // Diagnostics — env, host, clientId prefix (NOT secret), App Key prefix
         const clientIdPreview = `${clientId.slice(0, 6)}…${clientId.slice(-4)}`;
-        const appKeyPreview = `${appKey.slice(0, 6)}…${appKey.slice(-4)}`;
-        // eslint-disable-next-line no-console
-        console.log(`[ServiceTitan auth] env=${environment} tokenUrl=${tokenUrl} tenantId=${tenantId} clientId=${clientIdPreview} appKey=${appKeyPreview}`);
         const body = new URLSearchParams({
-            grant_type: 'client_credentials',
+            grant_type: "client_credentials",
             client_id: clientId,
             client_secret: clientSecret,
         }).toString();
         let response;
         try {
             response = (await this.helpers.httpRequest({
-                method: 'POST',
+                method: "POST",
                 url: tokenUrl,
                 headers: {
-                    'Content-Type': 'application/x-www-form-urlencoded',
+                    "Content-Type": "application/x-www-form-urlencoded",
                 },
                 body,
             }));
@@ -131,33 +129,31 @@ class ServiceTitanApi {
             const status = e.response?.status;
             const statusText = e.response?.statusText;
             const data = e.response?.data;
-            const bodyStr = typeof data === 'string' ? data : JSON.stringify(data);
-            const detail = bodyStr ? ` body=${bodyStr.slice(0, 500)}` : '';
-            throw new Error(`[ServiceTitan auth] Token fetch failed: ${status ?? '?'} ${statusText ?? ''}${detail}. ` +
+            const bodyStr = typeof data === "string" ? data : JSON.stringify(data);
+            const detail = bodyStr ? ` body=${bodyStr.slice(0, 500)}` : "";
+            throw new Error(`[ServiceTitan auth] Token fetch failed: ${status ?? "?"} ${statusText ?? ""}${detail}. ` +
                 `URL=${tokenUrl} env=${environment} clientId=${clientIdPreview}. ` +
                 `Verify Client ID/Secret are correct for the ${environment} environment.`);
         }
         if (!response?.access_token) {
             throw new Error(`[ServiceTitan auth] Token endpoint returned 2xx but no access_token. Response: ${JSON.stringify(response).slice(0, 500)}`);
         }
-        // eslint-disable-next-line no-console
-        console.log(`[ServiceTitan auth] Token fetch OK. expires_in=${response.expires_in}s`);
         return { accessToken: response.access_token, appKey };
     }
     authenticate = {
-        type: 'generic',
+        type: "generic",
         properties: {
             headers: {
-                Authorization: '=Bearer {{$credentials.accessToken}}',
-                'ST-App-Key': '={{$credentials.appKey}}',
+                Authorization: "=Bearer {{$credentials.accessToken}}",
+                "ST-App-Key": "={{$credentials.appKey}}",
             },
         },
     };
     test = {
         request: {
             baseURL: '=https://{{$credentials.environment === "production" ? "api.servicetitan.io" : "api-integration.servicetitan.io"}}',
-            url: '=/settings/v2/tenant/{{$credentials.tenantId}}/user-roles',
-            method: 'GET',
+            url: "=/settings/v2/tenant/{{$credentials.tenantId}}/user-roles",
+            method: "GET",
             qs: {
                 page: 1,
                 pageSize: 1,

package/dist/credentials/ServiceTitanApi.credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceTitanApi.credentials.js","sourceRoot":"","sources":["../../credentials/ServiceTitanApi.credentials.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ServiceTitanApi.credentials.js","sourceRoot":"","sources":["../../credentials/ServiceTitanApi.credentials.ts"],"names":[],"mappings":"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"}

package/dist/credentials/customAppSecrets.d.ts

@@ -0,0 +1,12 @@
+/**
+ * TGL custom app secrets live in a single n8n env var, TGL_CUSTOM_APP_SECRETS,
+ * holding a JSON array of { label, value } entries. Each TGL integration reads
+ * its own instance-level secret by label, keeping these values out of
+ * client-visible credential fields and out of per-integration env vars.
+ */
+/**
+ * Return the `value` of the TGL_CUSTOM_APP_SECRETS entry whose `label` matches.
+ * Fails hard (no fallback) with a distinct error for each failure mode so the
+ * cause is obvious in the n8n logs.
+ */
+export declare function getCustomAppSecret(label: string): string;

package/dist/credentials/customAppSecrets.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * TGL custom app secrets live in a single n8n env var, TGL_CUSTOM_APP_SECRETS,
+ * holding a JSON array of { label, value } entries. Each TGL integration reads
+ * its own instance-level secret by label, keeping these values out of
+ * client-visible credential fields and out of per-integration env vars.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCustomAppSecret = getCustomAppSecret;
+const ENV_VAR = 'TGL_CUSTOM_APP_SECRETS';
+/**
+ * Return the `value` of the TGL_CUSTOM_APP_SECRETS entry whose `label` matches.
+ * Fails hard (no fallback) with a distinct error for each failure mode so the
+ * cause is obvious in the n8n logs.
+ */
+function getCustomAppSecret(label) {
+    // eslint-disable-next-line @n8n/community-nodes/no-restricted-globals
+    const raw = process.env[ENV_VAR];
+    if (!raw) {
+        throw new Error(`[TGL secrets] ${ENV_VAR} env var is not set on this n8n service. Set it ` +
+            `on BOTH the n8n primary and worker services (a JSON array of ` +
+            `{ "label", "value" } objects), then redeploy.`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`[TGL secrets] ${ENV_VAR} could not be parsed as JSON. It must be a JSON ` +
+            `array of { "label", "value" } objects.`);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error(`[TGL secrets] ${ENV_VAR} must be a JSON array of { "label", "value" } objects.`);
+    }
+    const entry = parsed.find((s) => s?.label === label);
+    const value = entry?.value;
+    if (!value) {
+        throw new Error(`[TGL secrets] ${ENV_VAR} has no entry with a non-empty value for label ` +
+            `"${label}". Add { "label": "${label}", "value": "<secret>" } to the array.`);
+    }
+    return value;
+}
+//# sourceMappingURL=customAppSecrets.js.map

package/dist/credentials/customAppSecrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customAppSecrets.js","sourceRoot":"","sources":["../../credentials/customAppSecrets.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAcH,gDAqCC;AA5CD,MAAM,OAAO,GAAG,wBAAwB,CAAC;AAEzC;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,KAAa;IAC/C,sEAAsE;IACtE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACd,iBAAiB,OAAO,kDAAkD;YACzE,+DAA+D;YAC/D,+CAA+C,CAChD,CAAC;IACH,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,KAAK,CACd,iBAAiB,OAAO,kDAAkD;YACzE,wCAAwC,CACzC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACd,iBAAiB,OAAO,wDAAwD,CAChF,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAI,MAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,KAAK,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,CAAC;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACd,iBAAiB,OAAO,iDAAiD;YACxE,IAAI,KAAK,sBAAsB,KAAK,wCAAwC,CAC7E,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/nodes/ServiceTitan/ServiceTitan.node.d.ts

@@ -1,20 +1,4 @@
-import { type INodeType, type INodeTypeDescription } from 'n8n-workflow';
-/**
- * Action node for ServiceTitan.
- *
- * Naming convention notes:
- * - File basename `ServiceTitan.node.ts` must match the exported class name
- *   `ServiceTitan` — n8n's community-node loader does
- *   `new require(file)[fileBasename]()` to instantiate.
- * - `description.name` is `'serviceTitan'` (camelCase of the file basename).
- *   n8n's picker merges trigger+action into one app tile iff
- *   `triggerName.replace('Trigger', '') === actionName`, so the trigger MUST
- *   be `'serviceTitanTrigger'` for them to render as a single ServiceTitan tile.
- * - Collision risk with a future official n8n ServiceTitan node is handled by
- *   the npm scope: community packages are addressed as
- *   `<packageName>.<name>`, so `@thegraphitelab/n8n-nodes-servicetitan.serviceTitan`
- *   never collides with `n8n-nodes-base.serviceTitan` if n8n ever ships one.
- */
-export declare class ServiceTitan implements INodeType {
-    description: INodeTypeDescription;
+import { VersionedNodeType } from "n8n-workflow";
+export declare class ServiceTitan extends VersionedNodeType {
+    constructor();
 }

package/dist/nodes/ServiceTitan/ServiceTitan.node.js

@@ -2,67 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceTitan = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
-const resources_1 = require("./resources");
-/**
- * Action node for ServiceTitan.
- *
- * Naming convention notes:
- * - File basename `ServiceTitan.node.ts` must match the exported class name
- *   `ServiceTitan` — n8n's community-node loader does
- *   `new require(file)[fileBasename]()` to instantiate.
- * - `description.name` is `'serviceTitan'` (camelCase of the file basename).
- *   n8n's picker merges trigger+action into one app tile iff
- *   `triggerName.replace('Trigger', '') === actionName`, so the trigger MUST
- *   be `'serviceTitanTrigger'` for them to render as a single ServiceTitan tile.
- * - Collision risk with a future official n8n ServiceTitan node is handled by
- *   the npm scope: community packages are addressed as
- *   `<packageName>.<name>`, so `@thegraphitelab/n8n-nodes-servicetitan.serviceTitan`
- *   never collides with `n8n-nodes-base.serviceTitan` if n8n ever ships one.
- */
-class ServiceTitan {
-    description = {
-        displayName: 'ServiceTitan',
-        name: 'serviceTitan',
-        icon: {
-            light: 'file:servicetitan.svg',
-            dark: 'file:servicetitan.dark.svg',
-        },
-        group: ['transform'],
-        version: 1,
-        subtitle: '={{$parameter["operation"] || $parameter["event"]}}: {{$parameter["resource"]}}',
-        description: 'Interact with the ServiceTitan API',
-        defaults: {
-            name: 'ServiceTitan',
-        },
-        usableAsTool: true,
-        inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
-        outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
-        credentials: [
-            {
-                name: 'serviceTitanApi',
-                required: true,
-            },
-        ],
-        requestDefaults: {
-            baseURL: '=https://{{$credentials.environment === "production" ? "api.servicetitan.io" : "api-integration.servicetitan.io"}}',
-            headers: {
-                'Content-Type': 'application/json',
-                Accept: 'application/json',
-            },
-        },
-        properties: [
-            {
-                displayName: 'Resource',
-                name: 'resource',
-                type: 'options',
-                noDataExpression: true,
-                options: resources_1.resourceSelectOptions,
-                default: 'customer',
-            },
-            ...resources_1.allResources.flatMap((r) => r.resourceOperations),
-            ...resources_1.allResources.flatMap((r) => r.resourceFields),
-        ],
-    };
+const node_description_1 = require("./v1/descriptions/node.description");
+const ServiceTitanV1_node_1 = require("./v1/ServiceTitanV1.node");
+class ServiceTitan extends n8n_workflow_1.VersionedNodeType {
+    constructor() {
+        const nodeVersions = {
+            1: new ServiceTitanV1_node_1.ServiceTitanV1(node_description_1.baseDescription),
+        };
+        super(nodeVersions, node_description_1.baseDescription);
+    }
 }
 exports.ServiceTitan = ServiceTitan;
 //# sourceMappingURL=ServiceTitan.node.js.map

package/dist/nodes/ServiceTitan/ServiceTitan.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceTitan.node.js","sourceRoot":"","sources":["../../../nodes/ServiceTitan/ServiceTitan.node.ts"],"names":[],"mappings":";;;AAAA,+CAIsB;AAEtB,2CAAkE;AAElE;;;;;;;;;;;;;;;GAeG;AACH,MAAa,YAAY;IACxB,WAAW,GAAyB;QACnC,WAAW,EAAE,cAAc;QAC3B,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE;YACL,KAAK,EAAE,uBAAuB;YAC9B,IAAI,EAAE,4BAA4B;SAClC;QACD,KAAK,EAAE,CAAC,WAAW,CAAC;QACpB,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,iFAAiF;QAC3F,WAAW,EAAE,oCAAoC;QACjD,QAAQ,EAAE;YACT,IAAI,EAAE,cAAc;SACpB;QACD,YAAY,EAAE,IAAI;QAClB,MAAM,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;QAClC,OAAO,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;QACnC,WAAW,EAAE;YACZ;gBACC,IAAI,EAAE,iBAAiB;gBACvB,QAAQ,EAAE,IAAI;aACd;SACD;QACD,eAAe,EAAE;YAChB,OAAO,EACN,oHAAoH;YACrH,OAAO,EAAE;gBACR,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,kBAAkB;aAC1B;SACD;QACD,UAAU,EAAE;YACX;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,SAAS;gBACf,gBAAgB,EAAE,IAAI;gBACtB,OAAO,EAAE,iCAAqB;gBAC9B,OAAO,EAAE,UAAU;aACnB;YACD,GAAG,wBAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC;YACpD,GAAG,wBAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;SAChD;KACD,CAAC;CACF;AA7CD,oCA6CC"}
+{"version":3,"file":"ServiceTitan.node.js","sourceRoot":"","sources":["../../../nodes/ServiceTitan/ServiceTitan.node.ts"],"names":[],"mappings":";;;AAAA,+CAAqE;AACrE,yEAAqE;AACrE,kEAA0D;AAE1D,MAAa,YAAa,SAAQ,gCAAiB;IACjD;QACE,MAAM,YAAY,GAAuC;YACvD,CAAC,EAAE,IAAI,oCAAc,CAAC,kCAAe,CAAC;SACvC,CAAC;QAEF,KAAK,CAAC,YAAY,EAAE,kCAAe,CAAC,CAAC;IACvC,CAAC;CACF;AARD,oCAQC"}

package/dist/nodes/ServiceTitan/ServiceTitanTrigger.node.d.ts

@@ -1,10 +1,4 @@
-import { type ILoadOptionsFunctions, type INodeExecutionData, type INodePropertyOptions, type INodeType, type INodeTypeDescription, type IPollFunctions } from 'n8n-workflow';
-export declare class ServiceTitanTrigger implements INodeType {
-    description: INodeTypeDescription;
-    methods: {
-        loadOptions: {
-            getBusinessUnits(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
-        };
-    };
-    poll(this: IPollFunctions): Promise<INodeExecutionData[][] | null>;
+import { VersionedNodeType } from "n8n-workflow";
+export declare class ServiceTitanTrigger extends VersionedNodeType {
+    constructor();
 }