@thegraphitelab/n8n-nodes-servicetitan 0.4.0 → 0.6.0

package/README.md

@@ -1,48 +1,126 @@
 # @thegraphitelab/n8n-nodes-servicetitan
 
-n8n custom node for ServiceTitan. Internal use only — published to GitHub Packages under the `@thegraphitelab` scope.
+n8n custom node package for ServiceTitan. Built by The Graphite Lab, published publicly on npmjs.org under the `@thegraphitelab` scope. Primary consumer is TGL's Railway-hosted n8n fleet; the package is openly browsable.
 
-## Status
+**Current version: 0.6.0**
 
-Day-one scope:
-- **Credentials**: OAuth 2.0 client_credentials grant + ST-App-Key header, environment switch (Integration sandbox vs Production)
-- **Customer**: Get by ID
+## Installation
 
-More resources (Job, Invoice, Estimate, Technician, Booking, etc.) get added per the `CONTRIBUTING.md` recipe in the repo root.
+In each n8n instance, go to **Settings → Community Nodes → Install** and enter:
 
-## Credentials
+```
+@thegraphitelab/n8n-nodes-servicetitan
+```
+
+Accept the disclaimer and install.
+
+### Required env var
+
+Set on the n8n service (both primary and worker if running queue mode):
+
+```
+TGL_SERVICETITAN_APP_KEY=<TGL ServiceTitan ST-App-Key>
+```
+
+This is the TGL-owned `ST-App-Key` from our ServiceTitan developer portal app — same across all TGL clients, sourced from env so the value never sits in client-visible credential fields. See the [repo root README](../../README.md#installing-in-n8n) for the broader rationale.
+
+## What ships today
+
+### Credential: ServiceTitan API
+
+- OAuth 2.0 `client_credentials` grant
+- `ST-App-Key` header sourced from `TGL_SERVICETITAN_APP_KEY`
+- Environment switch: `Integration (Sandbox)` vs `Production`
+- `preAuthentication` caches an `expirable` `accessToken` in the credential data (15min TTL)
+- Test endpoint: `/settings/v2/tenant/{tenantId}/user-roles?page=1&pageSize=1`
+
+UI fields (per-client, set when creating the credential in n8n):
 
-Required UI fields (per-client, set when creating a credential in n8n):
 - **Environment** — `Integration (Sandbox)` or `Production`
-- **Tenant ID** — found in ServiceTitan → Settings → API Application Access
+- **Tenant ID** — from ServiceTitan → Settings → API Application Access
 - **Client ID** — OAuth client ID, per-client
 - **Client Secret** — OAuth client secret, per-client
 
-Required env var (set once per n8n instance, on **both** primary and worker services):
-- **`TGL_SERVICETITAN_APP_KEY`** — the `ST-App-Key`. TGL-owned application identifier, same across all TGL clients. Sourced from the TGL ServiceTitan developer portal app. Read from the env at request time, not stored per-credential.
+### Action node: ServiceTitan
+
+Picker label: **ServiceTitan**. Internal n8n name: `tglServiceTitan`.
+
+Resource + Operation pattern.
+
+| Resource | Operations |
+|---|---|
+| Customer | Get by ID |
+
+The Customer.Get response includes both raw `customFields[]` and a flattened `customFieldsByName` sibling object (see Custom fields below).
+
+### Trigger node: ServiceTitan Trigger
 
-The credential's "Test" button hits `/settings/v2/tenant/{tenantId}/user-roles?page=1&pageSize=1` to verify the full auth chain works.
+Picker label: **ServiceTitan Trigger**. Sits next to the action node in n8n's node picker when the user searches "ServiceTitan".
 
-## Auth flow
+Two-level Resource + Event picker inside the node, matching the action node's pattern. Resource determines which Event options show.
 
-1. n8n calls `preAuthentication` which POSTs `grant_type=client_credentials` to the env-correct token URL
-2. The returned `access_token` (TTL 15min) is cached in the credential data
-3. Each request injects `Authorization: Bearer <token>` AND `ST-App-Key: <appKey>` headers
-4. The `requestDefaults.baseURL` on the node switches between integration and production hosts based on `$credentials.environment`
+| Resource | Events |
+|---|---|
+| Job | Created or Modified |
+
+Polling-based with `modifiedOnOrAfter` cursor and a boundary-id dedup set to avoid duplicate emissions on overlap windows.
+
+## Architecture
+
+Resource-config table pattern. The trigger and action nodes share:
+
+- `GenericFunctions.ts` — `serviceTitanApiRequest`, pagination helpers, customFields flattening
+- `resources/<resource>/` — per-resource folder, one file per operation, declarative-style routing
+- `triggerResources.ts` — resource-config table that drives the trigger's two-level Resource + Event picker
+
+Adding a new resource or trigger event is a localized change — see [`CONTRIBUTING.md`](../../CONTRIBUTING.md) at the repo root.
+
+## Custom fields behavior
+
+ServiceTitan returns custom fields as an array of `{typeId, name, value}` objects. That shape is awkward to consume in downstream n8n nodes — every workflow has to write a JS-code step to find a field by name.
+
+This package returns **both** shapes on every entity that has custom fields:
+
+- `customFields` — the raw array, untouched, so anything that depends on the ServiceTitan shape still works
+- `customFieldsByName` — sibling object, keys are field names, values are `{typeId, value}`
+
+Downstream workflows can use `{{ $json.customFieldsByName["Field Name"].value }}` directly without a code step. A workflow that already does the manual flattening keeps working because `customFields` is unchanged.
+
+## Roadmap
+
+Phase 1 (current): refactored framework that scales, shipping the existing Customer.Get + Jobs trigger through it.
+
+Phase 3: port the rest of TGL's ServiceTitan Zapier operations resource-by-resource. Reference source: [`/Users/jacobnolley/projects/advanced_servicetitan_zapier_app`](../../../advanced_servicetitan_zapier_app) (the live Zapier custom app).
+
+Resources to port (non-exhaustive):
+- Jobs (more operations beyond the trigger)
+- Customers (full CRUD)
+- Estimates
+- Appointments
+- Invoices
+- Projects
+- Payments
+- Calls
+- Leads
+- Locations
+- Technicians
+- Vendors
+- Employees
+- Bookings
+
+Each resource lands as a minor bump; each new operation on an existing resource is a patch.
 
 ## Local dev
 
 ```bash
+# From this directory
 pnpm dev
-# Opens http://localhost:5678 with an embedded n8n and this node pre-loaded
 ```
 
-## Reference
-
-Endpoints and operation catalog are ported from `The-Graphite-Lab/advanced_servicetitan_zapier_app`.
+Boots embedded n8n at http://localhost:5678 with this package pre-loaded and hot reload. ServiceTitan sandbox credentials go in the local n8n credential store (`~/.n8n`).
 
-## TODO
+## Reference
 
-- [ ] Port additional resources (Job, Invoice, Estimate, Technician, Customer Note, etc.)
-- [ ] Add polling trigger node (`ServiceTitanTrigger`) using `modifiedOnOrAfter` filter
-- [ ] Wire usage metering to `api.thegraphitelab.com/usage` (matches the Zapier app's billing layer)
+- Repo root: [`../../README.md`](../../README.md)
+- Recipes for adding resources, trigger events, new packages: [`../../CONTRIBUTING.md`](../../CONTRIBUTING.md)
+- Source-of-truth Zapier app being ported from: `/Users/jacobnolley/projects/advanced_servicetitan_zapier_app`

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

@@ -0,0 +1,30 @@
+import type { IDataObject, IExecuteFunctions, IHttpRequestMethods, ILoadOptionsFunctions, IPollFunctions } from 'n8n-workflow';
+/**
+ * Shared ServiceTitan API request helper. Routes through n8n's auth helper so
+ * the ServiceTitanApi credential's preAuthentication (token refresh + ST-App-Key
+ * injection from TGL_SERVICETITAN_APP_KEY) runs on every call.
+ */
+export declare function serviceTitanApiRequest(this: IExecuteFunctions | IPollFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, path: string, qs?: IDataObject, body?: IDataObject | undefined): Promise<IDataObject>;
+/**
+ * Paginates a ServiceTitan list endpoint and returns the flattened set of
+ * `data[]` rows across all pages.
+ *
+ * Mirrors the trigger's pagination contract:
+ *   - 50-page safety cap (matches ServiceTitanTrigger)
+ *   - relies on response.hasMore as the loop terminator
+ *   - threads `page` through the query string; caller supplies the rest
+ *
+ * Caller is responsible for sort/filter qs. We do not enforce pageSize here
+ * because some ST endpoints have endpoint-specific caps.
+ */
+export declare function serviceTitanApiRequestAllItems(this: IExecuteFunctions | IPollFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, path: string, qs?: IDataObject, body?: IDataObject | undefined): Promise<IDataObject[]>;
+/**
+ * Returns the same item with a sibling `customFieldsByName` object added,
+ * keyed by the customField's `name`, mapping to `{ typeId, value }`.
+ *
+ * Idempotent and non-destructive:
+ *   - Original `customFields[]` array is left untouched
+ *   - Missing or non-array `customFields` returns the input unchanged
+ *   - Duplicate names: last write wins (ST doesn't normally emit duplicates)
+ */
+export declare function flattenCustomFields(item: IDataObject): IDataObject;

package/dist/nodes/ServiceTitan/GenericFunctions.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serviceTitanApiRequest = serviceTitanApiRequest;
+exports.serviceTitanApiRequestAllItems = serviceTitanApiRequestAllItems;
+exports.flattenCustomFields = flattenCustomFields;
+const ServiceTitanApi_credentials_1 = require("../../credentials/ServiceTitanApi.credentials");
+/**
+ * Shared ServiceTitan API request helper. Routes through n8n's auth helper so
+ * the ServiceTitanApi credential's preAuthentication (token refresh + ST-App-Key
+ * injection from TGL_SERVICETITAN_APP_KEY) runs on every call.
+ */
+async function serviceTitanApiRequest(method, path, qs = {}, body = undefined) {
+    const credentials = await this.getCredentials('serviceTitanApi');
+    const environment = credentials.environment ?? 'integration';
+    const apiHost = (0, ServiceTitanApi_credentials_1.getApiHost)(environment);
+    const options = {
+        method,
+        url: `https://${apiHost}${path}`,
+        qs,
+        headers: {
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+        },
+        json: true,
+    };
+    if (body !== undefined)
+        options.body = body;
+    return (await this.helpers.httpRequestWithAuthentication.call(this, 'serviceTitanApi', options));
+}
+/**
+ * Paginates a ServiceTitan list endpoint and returns the flattened set of
+ * `data[]` rows across all pages.
+ *
+ * Mirrors the trigger's pagination contract:
+ *   - 50-page safety cap (matches ServiceTitanTrigger)
+ *   - relies on response.hasMore as the loop terminator
+ *   - threads `page` through the query string; caller supplies the rest
+ *
+ * Caller is responsible for sort/filter qs. We do not enforce pageSize here
+ * because some ST endpoints have endpoint-specific caps.
+ */
+async function serviceTitanApiRequestAllItems(method, path, qs = {}, body = undefined) {
+    const collected = [];
+    let page = 1;
+    const maxPages = 50;
+    while (page <= maxPages) {
+        const response = (await serviceTitanApiRequest.call(this, method, path, { ...qs, page }, body));
+        if (Array.isArray(response.data)) {
+            collected.push(...response.data);
+        }
+        if (!response.hasMore)
+            break;
+        page += 1;
+    }
+    return collected;
+}
+/**
+ * Returns the same item with a sibling `customFieldsByName` object added,
+ * keyed by the customField's `name`, mapping to `{ typeId, value }`.
+ *
+ * Idempotent and non-destructive:
+ *   - Original `customFields[]` array is left untouched
+ *   - Missing or non-array `customFields` returns the input unchanged
+ *   - Duplicate names: last write wins (ST doesn't normally emit duplicates)
+ */
+function flattenCustomFields(item) {
+    const customFields = item.customFields;
+    if (!Array.isArray(customFields))
+        return item;
+    const byName = {};
+    for (const raw of customFields) {
+        if (!raw || typeof raw.name !== 'string')
+            continue;
+        byName[raw.name] = { typeId: raw.typeId, value: raw.value };
+    }
+    return { ...item, customFieldsByName: byName };
+}
+//# sourceMappingURL=GenericFunctions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GenericFunctions.js","sourceRoot":"","sources":["../../../nodes/ServiceTitan/GenericFunctions.ts"],"names":[],"mappings":";;AAiBA,wDA4BC;AAcD,wEAwBC;AAWD,kDAWC;AAhGD,+FAA2E;AAG3E;;;;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;AAED;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,8BAA8B,CAEnD,MAA2B,EAC3B,IAAY,EACZ,KAAkB,EAAE,EACpB,OAAgC,SAAS;IAEzC,MAAM,SAAS,GAAkB,EAAE,CAAC;IACpC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,QAAQ,GAAG,EAAE,CAAC;IAEpB,OAAO,IAAI,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,CAAC,MAAM,sBAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAClE,CAAC;QAE7B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,SAAS,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO;YAAE,MAAM;QAC7B,IAAI,IAAI,CAAC,CAAC;IACX,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,IAAiB;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,MAAM,GAAuD,EAAE,CAAC;IACtE,KAAK,MAAM,GAAG,IAAI,YAA+B,EAAE,CAAC;QACnD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QACnD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;IAC7D,CAAC;IAED,OAAO,EAAE,GAAG,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

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

@@ -0,0 +1,5 @@
+import { type INodeExecutionData, type INodeType, type INodeTypeDescription, type IPollFunctions } from 'n8n-workflow';
+export declare class ServiceTitanTrigger implements INodeType {
+    description: INodeTypeDescription;
+    poll(this: IPollFunctions): Promise<INodeExecutionData[][] | null>;
+}

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

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceTitanTrigger = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const GenericFunctions_1 = require("./GenericFunctions");
+const triggerResources_1 = require("./triggerResources");
+const JOB_STATUSES = ['Scheduled', 'InProgress', 'Hold', 'Completed', 'Canceled'];
+/**
+ * Resource dropdown options, derived from the TRIGGER_RESOURCES table.
+ */
+const resourceOptions = triggerResources_1.TRIGGER_RESOURCES.map((r) => ({
+    name: r.resourceLabel,
+    value: r.resource,
+}));
+/**
+ * Event property descriptors — one per resource, gated by displayOptions.show.resource.
+ * n8n renders the union of these as a single "Event" field whose option list swaps
+ * based on the selected Resource.
+ */
+const eventPropertyDefinitions = triggerResources_1.TRIGGER_RESOURCES.map((r) => ({
+    displayName: 'Event',
+    name: 'event',
+    type: 'options',
+    noDataExpression: true,
+    default: r.events[0]?.event ?? '',
+    displayOptions: { show: { resource: [r.resource] } },
+    options: r.events.map((e) => ({
+        name: e.label,
+        value: e.event,
+        description: e.description,
+    })),
+    description: 'ServiceTitan updates modifiedOn for any field change including internal status churn, so expect more fires than human-meaningful changes — filter downstream',
+}));
+class ServiceTitanTrigger {
+    description = {
+        displayName: 'ServiceTitan Trigger',
+        name: 'serviceTitanTrigger',
+        icon: {
+            light: 'file:servicetitan.svg',
+            dark: 'file:servicetitan.dark.svg',
+        },
+        group: ['trigger'],
+        version: 1,
+        description: 'Starts the workflow when ServiceTitan records are created or modified',
+        subtitle: '={{$parameter.resource}}: {{$parameter.event}}',
+        defaults: {
+            name: 'ServiceTitan Trigger',
+        },
+        polling: true,
+        usableAsTool: true,
+        inputs: [],
+        outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+        credentials: [
+            {
+                name: 'serviceTitanApi',
+                required: true,
+            },
+        ],
+        properties: [
+            {
+                displayName: 'Resource',
+                name: 'resource',
+                type: 'options',
+                noDataExpression: true,
+                default: 'job',
+                options: resourceOptions,
+            },
+            ...eventPropertyDefinitions,
+            {
+                // Job-specific filters. Gated on resource='job' so we can add other
+                // resources' filter collections side-by-side later.
+                displayName: 'Filters',
+                name: 'filters',
+                type: 'collection',
+                placeholder: 'Add Filter',
+                default: {},
+                displayOptions: { show: { resource: ['job'] } },
+                options: [
+                    {
+                        displayName: 'Business Unit ID',
+                        name: 'businessUnitId',
+                        type: 'string',
+                        default: '',
+                        description: 'Only emit jobs from this business unit',
+                    },
+                    {
+                        displayName: 'Customer ID',
+                        name: 'customerId',
+                        type: 'string',
+                        default: '',
+                    },
+                    {
+                        displayName: 'Include Inactive (Soft-Deleted)',
+                        name: 'includeInactive',
+                        type: 'boolean',
+                        default: false,
+                        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.',
+                    },
+                    {
+                        displayName: 'Job Status',
+                        name: 'jobStatus',
+                        type: 'multiOptions',
+                        default: [],
+                        options: JOB_STATUSES.map((s) => ({ name: s, value: s })),
+                        description: 'Only emit jobs with one of these statuses',
+                    },
+                    {
+                        displayName: 'Job Type ID',
+                        name: 'jobTypeId',
+                        type: 'string',
+                        default: '',
+                    },
+                ],
+            },
+        ],
+    };
+    async poll() {
+        const credentials = await this.getCredentials('serviceTitanApi');
+        const tenantId = credentials.tenantId;
+        const staticData = this.getWorkflowStaticData('node');
+        // If the underlying tenant changed (credential swap), wipe the cursor.
+        if (staticData.tenantId && staticData.tenantId !== tenantId) {
+            delete staticData.lastTimeChecked;
+            delete staticData.boundaryIds;
+        }
+        staticData.tenantId = tenantId;
+        const now = new Date().toISOString();
+        // First run: start the watermark at activation time so we don't drain ST history.
+        const since = staticData.lastTimeChecked ?? now;
+        const boundaryIds = new Set(staticData.boundaryIds ?? []);
+        const resource = this.getNodeParameter('resource', 0);
+        const event = this.getNodeParameter('event', 0);
+        const eventConfig = (0, triggerResources_1.findTriggerEvent)(resource, event);
+        if (!eventConfig) {
+            // Unrecognized resource/event pair — silently no-op rather than throw,
+            // matching the previous trigger's defensive shape.
+            return null;
+        }
+        const path = eventConfig.path.replace('{tenantId}', tenantId);
+        const timestampField = eventConfig.timestampField;
+        // Resource-specific filter handling. Job is the only one in Phase 1.
+        const baseQs = {
+            sort: eventConfig.sortField,
+            pageSize: 100,
+            includeTotal: false,
+        };
+        // ST's modifiedOnOrAfter / modifiedBefore convention is consistent across
+        // the jpm/crm/dispatch list endpoints for the `modifiedOn` cursor pattern.
+        // If future events need a different windowing field, add it to the config.
+        if (timestampField === 'modifiedOn') {
+            baseQs.modifiedOnOrAfter = since;
+            baseQs.modifiedBefore = now;
+        }
+        if (resource === 'job') {
+            const filters = this.getNodeParameter('filters', 0, {});
+            baseQs.active = filters.includeInactive ? 'Any' : 'True';
+            if (filters.jobStatus && filters.jobStatus.length > 0) {
+                baseQs.jobStatus = filters.jobStatus[0];
+            }
+            if (filters.businessUnitId)
+                baseQs.businessUnitId = filters.businessUnitId;
+            if (filters.jobTypeId)
+                baseQs.jobTypeId = filters.jobTypeId;
+            if (filters.customerId)
+                baseQs.customerId = filters.customerId;
+        }
+        const collected = [];
+        let page = 1;
+        const maxPages = 50;
+        try {
+            while (page <= maxPages) {
+                const response = (await GenericFunctions_1.serviceTitanApiRequest.call(this, 'GET', path, { ...baseQs, page }));
+                const rows = Array.isArray(response.data) ? response.data : [];
+                for (const row of rows) {
+                    const id = Number(row.id);
+                    if (Number.isFinite(id) && boundaryIds.has(id))
+                        continue;
+                    // Decision: emit BOTH raw customFields[] AND a flattened
+                    // customFieldsByName sibling.
+                    collected.push((0, GenericFunctions_1.flattenCustomFields)(row));
+                }
+                if (!response.hasMore)
+                    break;
+                page += 1;
+            }
+        }
+        catch (error) {
+            // Bubble up so n8n's poll runner logs it and retries next tick. We do NOT
+            // advance staticData here — same window will be re-polled.
+            throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
+        }
+        // Manual ("Fetch Test Event") mode: return one sample without burning the
+        // watermark, so users can wire downstream nodes safely.
+        if (this.getMode() === 'manual') {
+            if (collected.length === 0)
+                return null;
+            return [this.helpers.returnJsonArray(collected.slice(0, 1))];
+        }
+        // Advance cursor only on success.
+        staticData.lastTimeChecked = now;
+        // Boundary-id Set: ids of any returned row whose timestampField equals
+        // the new cursor, so the next poll's inclusive lower-bound doesn't
+        // duplicate-fire.
+        const newBoundary = [];
+        for (const row of collected) {
+            const ts = row[timestampField];
+            if (typeof ts === 'string' && ts === now) {
+                const id = Number(row.id);
+                if (Number.isFinite(id))
+                    newBoundary.push(id);
+            }
+        }
+        staticData.boundaryIds = newBoundary;
+        if (collected.length === 0)
+            return null;
+        return [this.helpers.returnJsonArray(collected)];
+    }
+}
+exports.ServiceTitanTrigger = ServiceTitanTrigger;
+//# sourceMappingURL=ServiceTitanTrigger.node.js.map

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

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

package/dist/nodes/ServiceTitan/ServiceTitanTrigger.node.json

@@ -0,0 +1,18 @@
+{
+    "node": "n8n-nodes-base.serviceTitanTrigger",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["Sales", "Productivity"],
+    "resources": {
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/thegraphitelab/tgl-custom-n8n-nodes/blob/main/packages/n8n-nodes-servicetitan/README.md"
+            }
+        ],
+        "credentialDocumentation": [
+            {
+                "url": "https://developer.servicetitan.io/"
+            }
+        ]
+    }
+}

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

@@ -1,4 +1,13 @@
 import { type INodeType, type INodeTypeDescription } from 'n8n-workflow';
-export declare class TglServiceTitan implements INodeType {
+/**
+ * Action node for ServiceTitan.
+ *
+ * Filename note: this file MUST stay named `TglServiceTitan.node.ts` because
+ * n8n's `node-filename-against-convention` lint rule maps the filename to the
+ * `name` field. We keep `name: 'tglServiceTitan'` for collision safety against
+ * any future official n8n ServiceTitan node, so the file follows. The exported
+ * class is `ServiceTitan` — that's what consumers (and the n8n loader) see.
+ */
+export declare class ServiceTitan implements INodeType {
     description: INodeTypeDescription;
 }

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

@@ -1,9 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TglServiceTitan = void 0;
+exports.ServiceTitan = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
-const customer_1 = require("./resources/customer");
-class TglServiceTitan {
+const resources_1 = require("./resources");
+/**
+ * Action node for ServiceTitan.
+ *
+ * Filename note: this file MUST stay named `TglServiceTitan.node.ts` because
+ * n8n's `node-filename-against-convention` lint rule maps the filename to the
+ * `name` field. We keep `name: 'tglServiceTitan'` for collision safety against
+ * any future official n8n ServiceTitan node, so the file follows. The exported
+ * class is `ServiceTitan` — that's what consumers (and the n8n loader) see.
+ */
+class ServiceTitan {
     description = {
         displayName: 'ServiceTitan',
         name: 'tglServiceTitan',
@@ -40,18 +49,13 @@ class TglServiceTitan {
                 name: 'resource',
                 type: 'options',
                 noDataExpression: true,
-                options: [
-                    {
-                        name: 'Customer',
-                        value: 'customer',
-                    },
-                ],
+                options: resources_1.resourceSelectOptions,
                 default: 'customer',
             },
-            ...customer_1.customerOperations,
-            ...customer_1.customerFields,
+            ...resources_1.allResources.flatMap((r) => r.resourceOperations),
+            ...resources_1.allResources.flatMap((r) => r.resourceFields),
         ],
     };
 }
-exports.TglServiceTitan = TglServiceTitan;
+exports.ServiceTitan = ServiceTitan;
 //# sourceMappingURL=TglServiceTitan.node.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"TglServiceTitan.node.js","sourceRoot":"","sources":["../../../nodes/ServiceTitan/TglServiceTitan.node.ts"],"names":[],"mappings":";;;AAAA,+CAIsB;AAEtB,mDAA0E;AAE1E,MAAa,eAAe;IAC3B,WAAW,GAAyB;QACnC,WAAW,EAAE,cAAc;QAC3B,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE;YACL,KAAK,EAAE,uBAAuB;YAC9B,IAAI,EAAE,4BAA4B;SAClC;QACD,KAAK,EAAE,CAAC,WAAW,CAAC;QACpB,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,oDAAoD;QAC9D,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;oBACR;wBACC,IAAI,EAAE,UAAU;wBAChB,KAAK,EAAE,UAAU;qBACjB;iBACD;gBACD,OAAO,EAAE,UAAU;aACnB;YACD,GAAG,6BAAkB;YACrB,GAAG,yBAAc;SACjB;KACD,CAAC;CACF;AAlDD,0CAkDC"}
+{"version":3,"file":"TglServiceTitan.node.js","sourceRoot":"","sources":["../../../nodes/ServiceTitan/TglServiceTitan.node.ts"],"names":[],"mappings":";;;AAAA,+CAIsB;AAEtB,2CAAkE;AAElE;;;;;;;;GAQG;AACH,MAAa,YAAY;IACxB,WAAW,GAAyB;QACnC,WAAW,EAAE,cAAc;QAC3B,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE;YACL,KAAK,EAAE,uBAAuB;YAC9B,IAAI,EAAE,4BAA4B;SAClC;QACD,KAAK,EAAE,CAAC,WAAW,CAAC;QACpB,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,oDAAoD;QAC9D,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"}

package/dist/nodes/ServiceTitan/resources/index.d.ts

@@ -0,0 +1,18 @@
+import type { INodeProperties, INodePropertyOptions } from 'n8n-workflow';
+/**
+ * Aggregator for action-node resources.
+ *
+ * Adding a new resource means:
+ *   1. Create resources/<name>/ with `<name>Operations` + `<name>Fields` exports
+ *   2. Add an entry to `allResources` below
+ *   3. Add a corresponding option to `resourceSelectOptions`
+ *
+ * The action node (TglServiceTitan.node.ts) spreads these directly into its
+ * `properties[]` and never has to be touched again for a new resource.
+ */
+export declare const resourceSelectOptions: INodePropertyOptions[];
+export interface ResourceBundle {
+    resourceOperations: INodeProperties[];
+    resourceFields: INodeProperties[];
+}
+export declare const allResources: ResourceBundle[];

package/dist/nodes/ServiceTitan/resources/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allResources = exports.resourceSelectOptions = void 0;
+const customer_1 = require("./customer");
+/**
+ * Aggregator for action-node resources.
+ *
+ * Adding a new resource means:
+ *   1. Create resources/<name>/ with `<name>Operations` + `<name>Fields` exports
+ *   2. Add an entry to `allResources` below
+ *   3. Add a corresponding option to `resourceSelectOptions`
+ *
+ * The action node (TglServiceTitan.node.ts) spreads these directly into its
+ * `properties[]` and never has to be touched again for a new resource.
+ */
+exports.resourceSelectOptions = [
+    {
+        name: 'Customer',
+        value: 'customer',
+    },
+];
+exports.allResources = [
+    {
+        resourceOperations: customer_1.customerOperations,
+        resourceFields: customer_1.customerFields,
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/nodes/ServiceTitan/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../nodes/ServiceTitan/resources/index.ts"],"names":[],"mappings":";;;AAEA,yCAAgE;AAEhE;;;;;;;;;;GAUG;AAEU,QAAA,qBAAqB,GAA2B;IAC5D;QACC,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;KACjB;CACD,CAAC;AAOW,QAAA,YAAY,GAAqB;IAC7C;QACC,kBAAkB,EAAE,6BAAkB;QACtC,cAAc,EAAE,yBAAc;KAC9B;CACD,CAAC"}

package/dist/nodes/ServiceTitan/servicetitan.dark.svg

@@ -1,4 +1,65 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
-  <rect width="64" height="64" rx="12" fill="#4F8AFF"/>
-  <text x="32" y="42" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif" font-weight="700" font-size="28" fill="#0B1220" text-anchor="middle">ST</text>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- ServiceTitan wordmark (dark-theme variant — white fill). Same paths as the light variant. -->
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="-131 222 585 106">
+<path fill="#FFFFFF" d="M41.8,264.1c-2.7-2.3-6.2-3.9-10.1-3.9c-2.7,0-6.2,1.6-6.2,4.7c0,3.5,3.9,4.7,6.6,5.5l3.9,1.2c8.2,2.3,14.4,6.2,14.4,15.6
+	c0,5.8-1.6,11.7-5.8,15.6c-4.7,3.9-10.5,5.5-16.4,5.5c-7.4,0-14.4-2.3-20.3-6.6l6.2-12.1c3.9,3.1,8.2,5.8,13.2,5.8
+	c3.5,0,7.4-1.9,7.4-5.8c0-4.3-5.8-5.8-9-6.6c-9.4-2.7-15.6-5.1-15.6-16.4c0-11.7,8.2-19.5,19.9-19.5c5.8,0,12.9,1.9,17.9,4.7
+	L41.8,264.1z M83.5,281.7c-0.8-3.9-4.3-6.2-7.8-6.2c-3.9,0-7.4,2.3-8.2,6.2H83.5z M96.4,289.5H67.1c0,5.8,3.1,9,8.6,9
+	c3.1,0,5.1-0.8,6.6-3.5h13.2c-2.3,9.7-10.9,13.6-19.9,13.6c-12.9,0-22.6-7.4-22.6-21c0-13.2,9-21,21.8-21c13.6,0,21.4,8.6,21.4,21.8
+	V289.5z M113.5,275.8c3.1-5.8,7.4-7.4,12.9-7.4h2.7v13.2c-2.3-1.2-3.9-1.2-5.8-1.2c-7.8,0-9.7,5.1-9.7,11.7v16H99.9v-39.4h13.6
+	V275.8z M151.7,288.7l9.4-19.9h15.6l-20.7,39h-9l-20.3-39h15.6L151.7,288.7z M192.2,307.8h-14.4v-39.4h14.4V307.8z M193,255.2
+	c0,4.3-3.5,7.8-7.8,7.8c-4.3,0-7.8-3.5-7.8-7.8c0-4.3,3.5-7.8,7.8-7.8C189.5,247.4,193,250.9,193,255.2z M227.7,280.5
+	c-2.3-1.6-4.7-2.7-7.4-2.7c-5.5,0-9.7,4.3-9.7,9.7c0,5.8,4.3,9.7,9.7,9.7c2.3,0,4.7-1.2,7-2.7v11.7c-3.5,1.6-6.6,2.3-9.7,2.3
+	c-11.7,0-21.4-8.6-21.4-20.6c0-12.5,9.7-21.4,22.2-21.4c3.1,0,6.6,0.8,9.4,2.3V280.5z M261.6,281.7c-0.8-3.9-4.3-6.2-7.8-6.2
+	c-3.9,0-7.4,2.3-8.2,6.2H261.6z M274.4,289.5h-29.2c0,5.8,3.1,9,8.6,9c3.1,0,5.1-0.8,6.6-3.5h13.2c-2.3,9.7-10.9,13.6-19.9,13.6
+	c-12.9,0-22.6-7.4-22.6-21c0-13.2,9-21,21.8-21c13.6,0,21.4,8.6,21.4,21.8V289.5z M302.1,307.8h-14.4V263h-12.9v-12.5h39.7V263
+	h-12.5V307.8z M331.7,307.8h-14v-39.4h14V307.8z M332.5,255.2c0,4.3-3.5,7.8-7.8,7.8s-7.8-3.5-7.8-7.8c0-4.3,3.5-7.8,7.8-7.8
+	S332.5,250.9,332.5,255.2z M354.3,307.8h-14v-27.7H336v-11.3h4.3v-12.1h14v12.1h7.8v11.3h-7.8V307.8z M376.1,288.3c0,5.1,3.1,9,9,9
+	c5.8,0,9-3.9,9-9c0-4.7-3.1-9-9-9C379.6,279.3,376.1,283.6,376.1,288.3z M407.7,307.8h-14v-4.3c-2.3,3.9-7.4,5.8-11.7,5.8
+	c-11.7,0-19.9-9.7-19.9-21s8.2-21,19.5-21c4.7,0,9,1.6,12.1,5.1v-3.9h14V307.8z M426,273.9c3.5-4.7,7.4-6.2,12.9-6.2
+	c10.5,0,14.8,6.6,14.8,16.4v24.2h-14v-19.1c0-3.9,0.8-10.1-6.2-10.1c-5.8,0-7.4,4.3-7.4,9v20.3h-14v-39.4h14V273.9z M460.7,266.5
+	v1.6h1.2c0.8,0,2.3,0,2.3-0.8c0-0.8-0.8-0.8-1.6-0.8H460.7z M464.9,272.3h-1.2l-1.6-3.1h-1.6v3.1h-0.8v-7h2.7c1.2,0,2.3,0.4,2.3,1.9
+	c0,1.2-0.8,1.9-1.9,1.9L464.9,272.3z M457.2,268.8c0,2.7,2.3,5.1,5.1,5.1c2.7,0,5.1-2.3,5.1-5.1c0-2.7-2.3-5.1-5.1-5.1
+	C459.5,263.8,457.2,265.7,457.2,268.8z M456,268.8c0-3.5,2.7-6.2,6.2-6.2c3.5,0,6.2,2.7,6.2,6.2c0,3.5-2.7,6.2-6.2,6.2
+	C458.7,274.7,456,271.9,456,268.8z M-121.8,317.1c0,0,5.8,2.3,5.8,4.7c0,0-0.4,1.9-2.3,1.9c-1.9,0-4.7-3.1-4.7-4.7
+	S-121.8,317.1-121.8,317.1z M-128,287.9C-128.4,287.9-128.4,287.5-128,287.9c-0.4-0.4-0.4-0.4-0.4-0.4c-1.2,0.4-3.1,1.9-3.1,4.7
+	c0,10.5,28.4,11.7,44,30.8c1.6,1.9,4.3,3.1,7,3.1c3.5,0,7-0.4,10.1-0.8c0.4,0,0.8-0.4,0.8-0.8c0-0.4,0-0.8,0-1.2
+	C-88.7,297.3-124.9,303.5-128,287.9z M-87.1,254.8c-1.9-1.9-7-0.4-9.7,1.9c-2.7,2.3-1.6,3.9-1.6,3.9c2.3-3.1,5.8-4.7,8.2-5.1
+	C-88.3,255.6-87.1,254.8-87.1,254.8z M-28.7,260.2c0,0-3.9,0.8-7.4-3.1c0,0,1.6,0,1.9-1.9C-34.5,255.2-32.2,259.5-28.7,260.2z
+	 M-29.9,278.2c0,0-0.8,4.3-5.8,4.3c-5.5,0-10.1-7.4-11.7-24.9c1.2,1.9,2.7,3.9,3.5,6.2c0-2.3,1.2-6.6-4.3-10.5
+	c0,0,14.4,3.1,14.8,17.9c0,2.7-1.6,5.1-2.3,6.2c0,0-0.8,0.4-0.4,1.6c0.4,0.8,1.6,0.8,2.7-0.4S-29.9,275.8-29.9,278.2z M-50.1,286.3
+	c0,0-3.9,7.4-9.4,7.4c-2.3,0-3.9-1.6-3.9-3.5s2.7-9.7,14-9.7c2.7,0,4.7,0.4,4.7,2.3C-44.3,284-47,286.7-50.1,286.3z M-50.1,249.3
+	c0,0-1.6-0.4-1.2-2.7c0.4-0.8,0.4-0.8,0.4-1.9c0-1.2,0.4-2.3,1.2-2.7c0,0,1.6,0,1.6,4.3C-48.2,248.2-50.1,249.3-50.1,249.3z
+	 M-55.2,249.3c-2.3-0.4-0.8-3.9-2.3-3.9c-0.8,0-0.8,3.9-1.6,3.5c-1.6-1.2-0.4-3.9-0.4-5.1c0-1.2,0.8-2.7-0.4-1.9
+	c-1.2,0.8-1.9,2.7-2.3,4.3c-0.4,1.6,0.4,2.3,1.2,4.3c0.8,1.9-0.4,1.2-0.4,1.2c-5.8-3.5-1.6-11.3-1.6-11.3c2.7-4.3,6.6-3.1,6.6-3.1
+	c0.8,0.4,0.8,0.8,0.8,1.6c0,0.8,0.4,1.2,1.2,1.6c1.2,0.4,1.6,1.6,1.6,3.9C-52.8,247-54.4,249.7-55.2,249.3z M-46.2,248.9l9.7,3.1
+	c0,0,1.9,3.5-1.9,2.3c-3.5-1.2-7-1.9-7-1.9S-47,251.3-46.2,248.9z M-94.1,263.7c-7,1.2-9.4-0.8-9.4-2.7c0-5.5,16-9.7,20.3-9.7
+	c0.8,1.2-0.8,1.2-1.2,3.1c-0.8,1.9-2.3,2.7-4.7,3.1c-2.3,0.4-4.7,1.6-6.2,2.7c-1.6,1.2,0,1.9,2.7,1.2c2.7-0.8,3.1,0.4,4.3,0
+	c1.2-0.4,0-1.9,0.8-1.9c0.8-0.4,2.3,0.8,2.3,0.8l3.9,2.7l-4.7,2.3c-0.4,0-0.8,0.4-0.8,1.2c0,0.8,2.3,0.8,3.5,0.8
+	c0.8,0,1.2,1.6,1.2,1.6c-1.2,1.6-4.7,1.6-4.7,1.6c0.8,1.6,5.1,1.2,5.8,1.6c0.8,0,0.8,1.2,1.6,3.1c0.4,1.9,3.1,2.7,3.1,2.7
+	c0.8,3.1-2.7,3.9-5.1,3.9C-95.7,280.9-94.1,263.7-94.1,263.7z M-92.6,241.9C-93,241.9-93,241.9-92.6,241.9
+	c-1.2-5.8,1.2-12.5,1.2-12.5s-5.8,4.7-5.5,12.5c-5.1,0-12.5,0.4-16.8,4.3c-6.2,5.1-7,14.8-7.4,17.5c0,0,0,0.4-0.4,0.4h-0.4
+	c-1.6-0.8-4.7-3.9-2.3-10.5c3.1-8.6,12.5-25.7,30.8-26.9c0,0,5.8-0.4,9.4,1.9c0,0,0.4,0,0.4,0.4v0.4c-1.6,1.2-6.6,5.8-8.2,12.9
+	c0,0.4-0.4,0.4-0.4,0.4C-92.2,241.9-92.6,241.9-92.6,241.9z M-78.9,264.9c0,0,1.6,7.4,5.1,10.1c0,0,0,0.8-1.2,0.8
+	c-1.2,0-3.1-1.6-3.9-5.8C-79.7,266.1-78.9,264.9-78.9,264.9z M-73.9,246.2c-4.3,0-6.2-3.9-6.2-3.9s5.1,4.7,12.1,0.8
+	C-68,243.5-69.6,246.2-73.9,246.2z M-20.1,252.5c-1.2-2.3-2.7-3.9-6.2-4.7c-3.1-0.8-5.8-0.4-7.8,1.2l-6.2-2.3
+	c-0.8-1.6-1.2-3.1-1.9-4.3c-0.4-1.2-1.2-1.9-1.9-2.3c-4.3-2.3-15.6-8.2-19.9-2.3c0,0-0.4,0.4-0.4,0.8l-1.6-0.4
+	c-0.8-2.3-3.1-4.3-6.2-5.1c-1.9-0.4-3.9-0.4-5.5,0.4c-1.2,0.4-1.2,1.9,0,2.3l5.1,1.9c1.2,0.4,1.9,1.6,1.2,2.7
+	c-0.4,1.2-1.6,1.9-2.7,1.2c0,0-3.1-0.8-5.5-1.6c-1.2-0.4-2.3,0.8-1.9,1.9c0.8,2.3,3.1,4.7,6.2,5.5c2.7,0.8,5.5,0,7.4-1.2l1.2,0.4
+	c0,2.7,2.3,6.2,4.3,7.4c3.1,1.9,5.8,0.4,9-1.6c0,0,8.2,6.2,4.3,24.5c-10.1,1.2-14,4.7-17.5,8.6c-2.3-0.8-9.4-1.6-13.2-0.4
+	c1.2-1.2,2.7-2.3,5.1-3.1c1.2-0.4,1.6-1.2,1.6-2.3c0,0,4.7-1.6,4.7-3.1c0-1.6-5.8-1.6-8.2-14c-0.4-1.6-0.8-2.7-3.1-3.5
+	c0,0-0.8-1.2,0.4-2.7c1.2-1.6,1.6-1.9,1.2-3.1c-0.4-1.2-1.9-1.9-1.9-1.9v-1.9c0,0-4.7-3.5-4.7-8.6c0-5.1,6.6-10.9,8.2-12.5v-0.4
+	c0,0,0-0.4-0.4-0.4c-2.3-1.6-6.6-3.9-13.6-3.9c-27.3,0-33.5,24.5-39.4,36.2c0,0.4,0,0.4,0,0.8c5.8,11.7,15.2,10.5,16,20.6
+	c0.4,7.8-1.6,7.8-3.1,7.8c-1.2,0-3.1-1.2-3.9-1.9h-0.4c0,0-0.4,0.4,0,0.4c0.8,1.9,2.7,6.6,9,6.6c3.1,0,3.9-2.7,3.9-5.5v-9
+	c0-0.8-0.4-1.6-0.8-2.3c-1.9-1.9-6.6-6.2-6.6-9.7c0-1.6,1.2-2.3,2.3-2.3c2.3,0,4.7,3.5,6.6,8.2c0.4,1.2,1.2,1.9,1.6,2.3h0.4
+	c0,0,0,0,0-0.4c-0.8-2.7-0.8-5.5-1.2-6.6c0-0.4-0.4-1.2-0.8-1.6c-1.9-1.6-6.6-6.2-6.6-13.2c0-9.4,15.2-8.6,18.3-8.6
+	c0.8,3.1,2.7,4.7,3.9,5.1c-4.7,1.6-14.8,5.1-14.8,10.9c0,6.2,10.5,5.8,10.5,5.8s-1.6,12.5,10.1,16.4c0,0-1.9,1.9-8.2,1.9
+	c-5.8,0-8.6-2.7-10.1-5.8c0,0,0-0.4-0.4-0.4c0,0-0.4,0-0.4,0.4c-0.4,0.8-0.4,2.3,0.4,3.9c1.6,2.7,3.9,4.3,3.9,7.8
+	c0,2.7-2.3,4.3-3.5,4.7c2.3,0.4,12.9,3.1,19.9,6.6c0.8-0.4,7-4.3,7.4-9.7c0,0,0.4-3.5-4.7-3.9c0,0,2.3-0.8,6.2-0.8
+	c3.9,0,8.2,3.1,0.4,19.5c0,0,0,0,0,0.4c1.2,0.8,10.1,6.6,16,12.1h0.4c0,0,0.4,0,0.4-0.4c0.8-0.8,2.3-3.5,3.1-10.1
+	c0-0.8,0.4-1.2,1.2-1.2c3.5-1.2,15.2-4.7,20.3-11.7c5.8-8.2,8.2-9.4,8.2-9.4s3.9-2.3,2.3-8.2c-0.8-3.1-5.5-10.9-10.1-19.1
+	c1.2,0.8,2.3,1.2,3.5,1.6c2.7,0.8,5.5,0.4,7.4-0.8c0.4-0.4,0.8-0.8,0.8-1.2c0-0.4-0.4-0.8-0.8-1.2l-5.1-1.9
+	c-1.2-0.4-1.9-1.9-1.6-3.1c0.4-1.2,1.9-1.9,3.1-1.6l4.7,1.6c0.4,0,0.8,0,1.2-0.4C-19.7,252.8-20.1,253.2-20.1,252.5z M-89.1,267.2
+	c0,0-1.9,0.4-1.6,3.5c0.4,2.7,2.7,2.7,2.7,2.7C-89.9,271.1-89.1,267.2-89.1,267.2z M-123,305.8c7,3.9,22.6,8.6,25.7,16.8
+	c0,0,1.2,1.9-5.1,1.9c-4.7,0-5.8-1.2-9-5.1c-4.7-5.5-14.4-9-14.4-13.2C-126.1,306.6-125.7,304.3-123,305.8z"/>
 </svg>

package/dist/nodes/ServiceTitan/servicetitan.svg

@@ -1,4 +1,65 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
-  <rect width="64" height="64" rx="12" fill="#0F62FE"/>
-  <text x="32" y="42" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif" font-weight="700" font-size="28" fill="#FFFFFF" text-anchor="middle">ST</text>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- ServiceTitan wordmark — official mark, sourced from Wikimedia Commons (public domain: consists only of simple geometric shapes and text). -->
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="-131 222 585 106">
+<path fill="#000000" d="M41.8,264.1c-2.7-2.3-6.2-3.9-10.1-3.9c-2.7,0-6.2,1.6-6.2,4.7c0,3.5,3.9,4.7,6.6,5.5l3.9,1.2c8.2,2.3,14.4,6.2,14.4,15.6
+	c0,5.8-1.6,11.7-5.8,15.6c-4.7,3.9-10.5,5.5-16.4,5.5c-7.4,0-14.4-2.3-20.3-6.6l6.2-12.1c3.9,3.1,8.2,5.8,13.2,5.8
+	c3.5,0,7.4-1.9,7.4-5.8c0-4.3-5.8-5.8-9-6.6c-9.4-2.7-15.6-5.1-15.6-16.4c0-11.7,8.2-19.5,19.9-19.5c5.8,0,12.9,1.9,17.9,4.7
+	L41.8,264.1z M83.5,281.7c-0.8-3.9-4.3-6.2-7.8-6.2c-3.9,0-7.4,2.3-8.2,6.2H83.5z M96.4,289.5H67.1c0,5.8,3.1,9,8.6,9
+	c3.1,0,5.1-0.8,6.6-3.5h13.2c-2.3,9.7-10.9,13.6-19.9,13.6c-12.9,0-22.6-7.4-22.6-21c0-13.2,9-21,21.8-21c13.6,0,21.4,8.6,21.4,21.8
+	V289.5z M113.5,275.8c3.1-5.8,7.4-7.4,12.9-7.4h2.7v13.2c-2.3-1.2-3.9-1.2-5.8-1.2c-7.8,0-9.7,5.1-9.7,11.7v16H99.9v-39.4h13.6
+	V275.8z M151.7,288.7l9.4-19.9h15.6l-20.7,39h-9l-20.3-39h15.6L151.7,288.7z M192.2,307.8h-14.4v-39.4h14.4V307.8z M193,255.2
+	c0,4.3-3.5,7.8-7.8,7.8c-4.3,0-7.8-3.5-7.8-7.8c0-4.3,3.5-7.8,7.8-7.8C189.5,247.4,193,250.9,193,255.2z M227.7,280.5
+	c-2.3-1.6-4.7-2.7-7.4-2.7c-5.5,0-9.7,4.3-9.7,9.7c0,5.8,4.3,9.7,9.7,9.7c2.3,0,4.7-1.2,7-2.7v11.7c-3.5,1.6-6.6,2.3-9.7,2.3
+	c-11.7,0-21.4-8.6-21.4-20.6c0-12.5,9.7-21.4,22.2-21.4c3.1,0,6.6,0.8,9.4,2.3V280.5z M261.6,281.7c-0.8-3.9-4.3-6.2-7.8-6.2
+	c-3.9,0-7.4,2.3-8.2,6.2H261.6z M274.4,289.5h-29.2c0,5.8,3.1,9,8.6,9c3.1,0,5.1-0.8,6.6-3.5h13.2c-2.3,9.7-10.9,13.6-19.9,13.6
+	c-12.9,0-22.6-7.4-22.6-21c0-13.2,9-21,21.8-21c13.6,0,21.4,8.6,21.4,21.8V289.5z M302.1,307.8h-14.4V263h-12.9v-12.5h39.7V263
+	h-12.5V307.8z M331.7,307.8h-14v-39.4h14V307.8z M332.5,255.2c0,4.3-3.5,7.8-7.8,7.8s-7.8-3.5-7.8-7.8c0-4.3,3.5-7.8,7.8-7.8
+	S332.5,250.9,332.5,255.2z M354.3,307.8h-14v-27.7H336v-11.3h4.3v-12.1h14v12.1h7.8v11.3h-7.8V307.8z M376.1,288.3c0,5.1,3.1,9,9,9
+	c5.8,0,9-3.9,9-9c0-4.7-3.1-9-9-9C379.6,279.3,376.1,283.6,376.1,288.3z M407.7,307.8h-14v-4.3c-2.3,3.9-7.4,5.8-11.7,5.8
+	c-11.7,0-19.9-9.7-19.9-21s8.2-21,19.5-21c4.7,0,9,1.6,12.1,5.1v-3.9h14V307.8z M426,273.9c3.5-4.7,7.4-6.2,12.9-6.2
+	c10.5,0,14.8,6.6,14.8,16.4v24.2h-14v-19.1c0-3.9,0.8-10.1-6.2-10.1c-5.8,0-7.4,4.3-7.4,9v20.3h-14v-39.4h14V273.9z M460.7,266.5
+	v1.6h1.2c0.8,0,2.3,0,2.3-0.8c0-0.8-0.8-0.8-1.6-0.8H460.7z M464.9,272.3h-1.2l-1.6-3.1h-1.6v3.1h-0.8v-7h2.7c1.2,0,2.3,0.4,2.3,1.9
+	c0,1.2-0.8,1.9-1.9,1.9L464.9,272.3z M457.2,268.8c0,2.7,2.3,5.1,5.1,5.1c2.7,0,5.1-2.3,5.1-5.1c0-2.7-2.3-5.1-5.1-5.1
+	C459.5,263.8,457.2,265.7,457.2,268.8z M456,268.8c0-3.5,2.7-6.2,6.2-6.2c3.5,0,6.2,2.7,6.2,6.2c0,3.5-2.7,6.2-6.2,6.2
+	C458.7,274.7,456,271.9,456,268.8z M-121.8,317.1c0,0,5.8,2.3,5.8,4.7c0,0-0.4,1.9-2.3,1.9c-1.9,0-4.7-3.1-4.7-4.7
+	S-121.8,317.1-121.8,317.1z M-128,287.9C-128.4,287.9-128.4,287.5-128,287.9c-0.4-0.4-0.4-0.4-0.4-0.4c-1.2,0.4-3.1,1.9-3.1,4.7
+	c0,10.5,28.4,11.7,44,30.8c1.6,1.9,4.3,3.1,7,3.1c3.5,0,7-0.4,10.1-0.8c0.4,0,0.8-0.4,0.8-0.8c0-0.4,0-0.8,0-1.2
+	C-88.7,297.3-124.9,303.5-128,287.9z M-87.1,254.8c-1.9-1.9-7-0.4-9.7,1.9c-2.7,2.3-1.6,3.9-1.6,3.9c2.3-3.1,5.8-4.7,8.2-5.1
+	C-88.3,255.6-87.1,254.8-87.1,254.8z M-28.7,260.2c0,0-3.9,0.8-7.4-3.1c0,0,1.6,0,1.9-1.9C-34.5,255.2-32.2,259.5-28.7,260.2z
+	 M-29.9,278.2c0,0-0.8,4.3-5.8,4.3c-5.5,0-10.1-7.4-11.7-24.9c1.2,1.9,2.7,3.9,3.5,6.2c0-2.3,1.2-6.6-4.3-10.5
+	c0,0,14.4,3.1,14.8,17.9c0,2.7-1.6,5.1-2.3,6.2c0,0-0.8,0.4-0.4,1.6c0.4,0.8,1.6,0.8,2.7-0.4S-29.9,275.8-29.9,278.2z M-50.1,286.3
+	c0,0-3.9,7.4-9.4,7.4c-2.3,0-3.9-1.6-3.9-3.5s2.7-9.7,14-9.7c2.7,0,4.7,0.4,4.7,2.3C-44.3,284-47,286.7-50.1,286.3z M-50.1,249.3
+	c0,0-1.6-0.4-1.2-2.7c0.4-0.8,0.4-0.8,0.4-1.9c0-1.2,0.4-2.3,1.2-2.7c0,0,1.6,0,1.6,4.3C-48.2,248.2-50.1,249.3-50.1,249.3z
+	 M-55.2,249.3c-2.3-0.4-0.8-3.9-2.3-3.9c-0.8,0-0.8,3.9-1.6,3.5c-1.6-1.2-0.4-3.9-0.4-5.1c0-1.2,0.8-2.7-0.4-1.9
+	c-1.2,0.8-1.9,2.7-2.3,4.3c-0.4,1.6,0.4,2.3,1.2,4.3c0.8,1.9-0.4,1.2-0.4,1.2c-5.8-3.5-1.6-11.3-1.6-11.3c2.7-4.3,6.6-3.1,6.6-3.1
+	c0.8,0.4,0.8,0.8,0.8,1.6c0,0.8,0.4,1.2,1.2,1.6c1.2,0.4,1.6,1.6,1.6,3.9C-52.8,247-54.4,249.7-55.2,249.3z M-46.2,248.9l9.7,3.1
+	c0,0,1.9,3.5-1.9,2.3c-3.5-1.2-7-1.9-7-1.9S-47,251.3-46.2,248.9z M-94.1,263.7c-7,1.2-9.4-0.8-9.4-2.7c0-5.5,16-9.7,20.3-9.7
+	c0.8,1.2-0.8,1.2-1.2,3.1c-0.8,1.9-2.3,2.7-4.7,3.1c-2.3,0.4-4.7,1.6-6.2,2.7c-1.6,1.2,0,1.9,2.7,1.2c2.7-0.8,3.1,0.4,4.3,0
+	c1.2-0.4,0-1.9,0.8-1.9c0.8-0.4,2.3,0.8,2.3,0.8l3.9,2.7l-4.7,2.3c-0.4,0-0.8,0.4-0.8,1.2c0,0.8,2.3,0.8,3.5,0.8
+	c0.8,0,1.2,1.6,1.2,1.6c-1.2,1.6-4.7,1.6-4.7,1.6c0.8,1.6,5.1,1.2,5.8,1.6c0.8,0,0.8,1.2,1.6,3.1c0.4,1.9,3.1,2.7,3.1,2.7
+	c0.8,3.1-2.7,3.9-5.1,3.9C-95.7,280.9-94.1,263.7-94.1,263.7z M-92.6,241.9C-93,241.9-93,241.9-92.6,241.9
+	c-1.2-5.8,1.2-12.5,1.2-12.5s-5.8,4.7-5.5,12.5c-5.1,0-12.5,0.4-16.8,4.3c-6.2,5.1-7,14.8-7.4,17.5c0,0,0,0.4-0.4,0.4h-0.4
+	c-1.6-0.8-4.7-3.9-2.3-10.5c3.1-8.6,12.5-25.7,30.8-26.9c0,0,5.8-0.4,9.4,1.9c0,0,0.4,0,0.4,0.4v0.4c-1.6,1.2-6.6,5.8-8.2,12.9
+	c0,0.4-0.4,0.4-0.4,0.4C-92.2,241.9-92.6,241.9-92.6,241.9z M-78.9,264.9c0,0,1.6,7.4,5.1,10.1c0,0,0,0.8-1.2,0.8
+	c-1.2,0-3.1-1.6-3.9-5.8C-79.7,266.1-78.9,264.9-78.9,264.9z M-73.9,246.2c-4.3,0-6.2-3.9-6.2-3.9s5.1,4.7,12.1,0.8
+	C-68,243.5-69.6,246.2-73.9,246.2z M-20.1,252.5c-1.2-2.3-2.7-3.9-6.2-4.7c-3.1-0.8-5.8-0.4-7.8,1.2l-6.2-2.3
+	c-0.8-1.6-1.2-3.1-1.9-4.3c-0.4-1.2-1.2-1.9-1.9-2.3c-4.3-2.3-15.6-8.2-19.9-2.3c0,0-0.4,0.4-0.4,0.8l-1.6-0.4
+	c-0.8-2.3-3.1-4.3-6.2-5.1c-1.9-0.4-3.9-0.4-5.5,0.4c-1.2,0.4-1.2,1.9,0,2.3l5.1,1.9c1.2,0.4,1.9,1.6,1.2,2.7
+	c-0.4,1.2-1.6,1.9-2.7,1.2c0,0-3.1-0.8-5.5-1.6c-1.2-0.4-2.3,0.8-1.9,1.9c0.8,2.3,3.1,4.7,6.2,5.5c2.7,0.8,5.5,0,7.4-1.2l1.2,0.4
+	c0,2.7,2.3,6.2,4.3,7.4c3.1,1.9,5.8,0.4,9-1.6c0,0,8.2,6.2,4.3,24.5c-10.1,1.2-14,4.7-17.5,8.6c-2.3-0.8-9.4-1.6-13.2-0.4
+	c1.2-1.2,2.7-2.3,5.1-3.1c1.2-0.4,1.6-1.2,1.6-2.3c0,0,4.7-1.6,4.7-3.1c0-1.6-5.8-1.6-8.2-14c-0.4-1.6-0.8-2.7-3.1-3.5
+	c0,0-0.8-1.2,0.4-2.7c1.2-1.6,1.6-1.9,1.2-3.1c-0.4-1.2-1.9-1.9-1.9-1.9v-1.9c0,0-4.7-3.5-4.7-8.6c0-5.1,6.6-10.9,8.2-12.5v-0.4
+	c0,0,0-0.4-0.4-0.4c-2.3-1.6-6.6-3.9-13.6-3.9c-27.3,0-33.5,24.5-39.4,36.2c0,0.4,0,0.4,0,0.8c5.8,11.7,15.2,10.5,16,20.6
+	c0.4,7.8-1.6,7.8-3.1,7.8c-1.2,0-3.1-1.2-3.9-1.9h-0.4c0,0-0.4,0.4,0,0.4c0.8,1.9,2.7,6.6,9,6.6c3.1,0,3.9-2.7,3.9-5.5v-9
+	c0-0.8-0.4-1.6-0.8-2.3c-1.9-1.9-6.6-6.2-6.6-9.7c0-1.6,1.2-2.3,2.3-2.3c2.3,0,4.7,3.5,6.6,8.2c0.4,1.2,1.2,1.9,1.6,2.3h0.4
+	c0,0,0,0,0-0.4c-0.8-2.7-0.8-5.5-1.2-6.6c0-0.4-0.4-1.2-0.8-1.6c-1.9-1.6-6.6-6.2-6.6-13.2c0-9.4,15.2-8.6,18.3-8.6
+	c0.8,3.1,2.7,4.7,3.9,5.1c-4.7,1.6-14.8,5.1-14.8,10.9c0,6.2,10.5,5.8,10.5,5.8s-1.6,12.5,10.1,16.4c0,0-1.9,1.9-8.2,1.9
+	c-5.8,0-8.6-2.7-10.1-5.8c0,0,0-0.4-0.4-0.4c0,0-0.4,0-0.4,0.4c-0.4,0.8-0.4,2.3,0.4,3.9c1.6,2.7,3.9,4.3,3.9,7.8
+	c0,2.7-2.3,4.3-3.5,4.7c2.3,0.4,12.9,3.1,19.9,6.6c0.8-0.4,7-4.3,7.4-9.7c0,0,0.4-3.5-4.7-3.9c0,0,2.3-0.8,6.2-0.8
+	c3.9,0,8.2,3.1,0.4,19.5c0,0,0,0,0,0.4c1.2,0.8,10.1,6.6,16,12.1h0.4c0,0,0.4,0,0.4-0.4c0.8-0.8,2.3-3.5,3.1-10.1
+	c0-0.8,0.4-1.2,1.2-1.2c3.5-1.2,15.2-4.7,20.3-11.7c5.8-8.2,8.2-9.4,8.2-9.4s3.9-2.3,2.3-8.2c-0.8-3.1-5.5-10.9-10.1-19.1
+	c1.2,0.8,2.3,1.2,3.5,1.6c2.7,0.8,5.5,0.4,7.4-0.8c0.4-0.4,0.8-0.8,0.8-1.2c0-0.4-0.4-0.8-0.8-1.2l-5.1-1.9
+	c-1.2-0.4-1.9-1.9-1.6-3.1c0.4-1.2,1.9-1.9,3.1-1.6l4.7,1.6c0.4,0,0.8,0,1.2-0.4C-19.7,252.8-20.1,253.2-20.1,252.5z M-89.1,267.2
+	c0,0-1.9,0.4-1.6,3.5c0.4,2.7,2.7,2.7,2.7,2.7C-89.9,271.1-89.1,267.2-89.1,267.2z M-123,305.8c7,3.9,22.6,8.6,25.7,16.8
+	c0,0,1.2,1.9-5.1,1.9c-4.7,0-5.8-1.2-9-5.1c-4.7-5.5-14.4-9-14.4-13.2C-126.1,306.6-125.7,304.3-123,305.8z"/>
 </svg>

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

@@ -0,0 +1,37 @@
+/**
+ * Trigger resource/event configuration table.
+ *
+ * The ServiceTitan trigger uses a two-level Resource → Event picker. This
+ * table is the single source of truth for which (resource, event) pairs the
+ * trigger supports and how they map to the underlying ST list endpoint.
+ *
+ * To add a new event in Phase 3, add an entry here and (if needed) gate any
+ * resource-specific filters on `resource` via displayOptions in the node.
+ */
+export interface TriggerEventConfig {
+    /** Internal event value within the resource (e.g. 'createdOrModified'). */
+    event: string;
+    /** UI label for the event dropdown. */
+    label: string;
+    /** UI description shown under the dropdown. */
+    description: string;
+    /** ServiceTitan list endpoint path. `{tenantId}` is substituted at poll-time. */
+    path: string;
+    /** Sort parameter to pass to ST (e.g. '+ModifiedOn'). */
+    sortField: string;
+    /** Field on the row used for boundary-id dedup (e.g. 'modifiedOn'). */
+    timestampField: string;
+}
+export interface TriggerResourceConfig {
+    /** Internal resource value (e.g. 'job'). */
+    resource: string;
+    /** UI label for the resource dropdown. */
+    resourceLabel: string;
+    events: TriggerEventConfig[];
+}
+export declare const TRIGGER_RESOURCES: TriggerResourceConfig[];
+/**
+ * Lookup helper — returns the event config for the chosen resource+event, or
+ * undefined if the pair isn't recognized.
+ */
+export declare function findTriggerEvent(resource: string, event: string): TriggerEventConfig | undefined;

package/dist/nodes/ServiceTitan/triggerResources.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Trigger resource/event configuration table.
+ *
+ * The ServiceTitan trigger uses a two-level Resource → Event picker. This
+ * table is the single source of truth for which (resource, event) pairs the
+ * trigger supports and how they map to the underlying ST list endpoint.
+ *
+ * To add a new event in Phase 3, add an entry here and (if needed) gate any
+ * resource-specific filters on `resource` via displayOptions in the node.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRIGGER_RESOURCES = void 0;
+exports.findTriggerEvent = findTriggerEvent;
+exports.TRIGGER_RESOURCES = [
+    {
+        resource: 'job',
+        resourceLabel: 'Job',
+        events: [
+            {
+                event: 'createdOrModified',
+                label: 'Created or Modified',
+                description: 'Fires for any job whose modifiedOn has advanced since the last poll',
+                path: '/jpm/v2/tenant/{tenantId}/jobs',
+                sortField: '+ModifiedOn',
+                timestampField: 'modifiedOn',
+            },
+        ],
+    },
+];
+/**
+ * Lookup helper — returns the event config for the chosen resource+event, or
+ * undefined if the pair isn't recognized.
+ */
+function findTriggerEvent(resource, event) {
+    const r = exports.TRIGGER_RESOURCES.find((entry) => entry.resource === resource);
+    return r?.events.find((e) => e.event === event);
+}
+//# sourceMappingURL=triggerResources.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triggerResources.js","sourceRoot":"","sources":["../../../nodes/ServiceTitan/triggerResources.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AA+CH,4CAMC;AA5BY,QAAA,iBAAiB,GAA4B;IACzD;QACC,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,KAAK;QACpB,MAAM,EAAE;YACP;gBACC,KAAK,EAAE,mBAAmB;gBAC1B,KAAK,EAAE,qBAAqB;gBAC5B,WAAW,EACV,qEAAqE;gBACtE,IAAI,EAAE,gCAAgC;gBACtC,SAAS,EAAE,aAAa;gBACxB,cAAc,EAAE,YAAY;aAC5B;SACD;KACD;CACD,CAAC;AAEF;;;GAGG;AACH,SAAgB,gBAAgB,CAC/B,QAAgB,EAChB,KAAa;IAEb,MAAM,CAAC,GAAG,yBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AACjD,CAAC"}

package/dist/nodes/ServiceTitan/types/common.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared, low-churn ServiceTitan API shapes.
+ *
+ * These are first-pass and intentionally narrow — only fields we actively read
+ * across the codebase. Extend as new resources are ported.
+ */
+/**
+ * Standard ServiceTitan list-envelope. Almost every ST list endpoint returns
+ * the same wrapper: page metadata + a `data` array of the resource.
+ */
+export interface STListEnvelope<T> {
+    page?: number;
+    pageSize?: number;
+    hasMore?: boolean;
+    totalCount?: number;
+    data?: T[];
+}
+/**
+ * Raw shape ServiceTitan returns inside `customFields[]` on most resources.
+ * `value` is `unknown` because ST encodes typed values per `typeId` and we
+ * don't normalize them yet.
+ */
+export interface STCustomField {
+    name: string;
+    typeId: number;
+    value: unknown;
+}

package/dist/nodes/ServiceTitan/types/common.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Shared, low-churn ServiceTitan API shapes.
+ *
+ * These are first-pass and intentionally narrow — only fields we actively read
+ * across the codebase. Extend as new resources are ported.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=common.js.map

package/dist/nodes/ServiceTitan/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../nodes/ServiceTitan/types/common.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/nodes/ServiceTitan/types/customer.d.ts

@@ -0,0 +1,15 @@
+import type { STCustomField } from './common';
+/**
+ * Minimal ServiceTitan `Customer` shape. First-pass — extend as the Customer
+ * resource grows beyond Customer.Get.
+ */
+export interface Customer {
+    id: number;
+    name: string;
+    type?: string;
+    address?: unknown;
+    customFields?: STCustomField[];
+    modifiedOn?: string;
+    createdOn?: string;
+    active: boolean;
+}

package/dist/nodes/ServiceTitan/types/customer.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=customer.js.map

package/dist/nodes/ServiceTitan/types/customer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer.js","sourceRoot":"","sources":["../../../../nodes/ServiceTitan/types/customer.ts"],"names":[],"mappings":""}

package/dist/nodes/ServiceTitan/types/index.d.ts

@@ -0,0 +1,3 @@
+export type { STListEnvelope, STCustomField } from './common';
+export type { Job } from './job';
+export type { Customer } from './customer';

package/dist/nodes/ServiceTitan/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/nodes/ServiceTitan/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../nodes/ServiceTitan/types/index.ts"],"names":[],"mappings":""}

package/dist/nodes/ServiceTitan/types/job.d.ts

@@ -0,0 +1,21 @@
+import type { STCustomField } from './common';
+/**
+ * Subset of the ServiceTitan `Job` shape we read in the trigger and downstream
+ * helpers. First-pass — extend as new fields are needed.
+ */
+export interface Job {
+    id: number;
+    jobNumber?: string;
+    customerId?: number;
+    locationId?: number;
+    jobStatus?: string;
+    businessUnitId?: number;
+    jobTypeId?: number;
+    campaignId?: number;
+    modifiedOn?: string;
+    createdOn?: string;
+    completedOn?: string;
+    summary?: string;
+    customFields?: STCustomField[];
+    jobAssignments?: unknown[];
+}

package/dist/nodes/ServiceTitan/types/job.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=job.js.map

package/dist/nodes/ServiceTitan/types/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../../../../nodes/ServiceTitan/types/job.ts"],"names":[],"mappings":""}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@thegraphitelab/n8n-nodes-servicetitan",
-    "version": "0.4.0",
+    "version": "0.6.0",
     "description": "n8n custom node for ServiceTitan — TGL internal use.",
     "keywords": [
         "n8n-community-node-package",
@@ -44,7 +44,8 @@
             "dist/credentials/ServiceTitanApi.credentials.js"
         ],
         "nodes": [
-            "dist/nodes/ServiceTitan/TglServiceTitan.node.js"
+            "dist/nodes/ServiceTitan/TglServiceTitan.node.js",
+            "dist/nodes/ServiceTitan/ServiceTitanTrigger.node.js"
         ]
     },
     "devDependencies": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thegraphitelab/n8n-nodes-servicetitan",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "n8n custom node for ServiceTitan — TGL internal use.",
   "keywords": [
     "n8n-community-node-package",
@@ -37,7 +37,8 @@
       "dist/credentials/ServiceTitanApi.credentials.js"
     ],
     "nodes": [
-      "dist/nodes/ServiceTitan/TglServiceTitan.node.js"
+      "dist/nodes/ServiceTitan/TglServiceTitan.node.js",
+      "dist/nodes/ServiceTitan/ServiceTitanTrigger.node.js"
     ]
   },
   "devDependencies": {