n8n-nodes-servicem8-jobcreation 1.0.0

package/dist/nodes/ServiceM8JobCreation/execute.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Execute Method
+ * Main execution logic for the ServiceM8 Smart Job Creation node
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = void 0;
+const operations_1 = require("./operations");
+const types_1 = require("./types");
+async function execute() {
+    const items = this.getInputData();
+    const returnData = [];
+    for (let i = 0; i < items.length; i++) {
+        try {
+            const operation = this.getNodeParameter('operation', i);
+            let result;
+            if (operation === 'update') {
+                result = (await (0, operations_1.executeJobUpdate)(this, i));
+            }
+            else {
+                result = (await (0, operations_1.executeJobCreation)(this, i));
+            }
+            returnData.push({
+                json: result,
+                pairedItem: i,
+            });
+        }
+        catch (error) {
+            if (this.continueOnFail()) {
+                const operation = this.getNodeParameter('operation', i);
+                const errorResult = operation === 'update'
+                    ? { ...(0, types_1.createEmptyUpdateResult)(), error: error.message }
+                    : { ...(0, types_1.createEmptyExecutionResult)(), error: error.message };
+                returnData.push({
+                    json: errorResult,
+                    pairedItem: i,
+                });
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    return [returnData];
+}
+exports.execute = execute;
+//# sourceMappingURL=execute.js.map

package/dist/nodes/ServiceM8JobCreation/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../nodes/ServiceM8JobCreation/execute.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,6CAAoE;AACpE,mCAA8E;AAEvE,KAAK,UAAU,OAAO;IAG5B,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IAClC,MAAM,UAAU,GAAyB,EAAE,CAAC;IAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACtC,IAAI;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAW,CAAC;YAElE,IAAI,MAAmB,CAAC;YACxB,IAAI,SAAS,KAAK,QAAQ,EAAE;gBAC3B,MAAM,GAAG,CAAC,MAAM,IAAA,6BAAgB,EAAC,IAAI,EAAE,CAAC,CAAC,CAA2B,CAAC;aACrE;iBAAM;gBACN,MAAM,GAAG,CAAC,MAAM,IAAA,+BAAkB,EAAC,IAAI,EAAE,CAAC,CAAC,CAA2B,CAAC;aACvE;YAED,UAAU,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,MAAM;gBACZ,UAAU,EAAE,CAAC;aACb,CAAC,CAAC;SACH;QAAC,OAAO,KAAK,EAAE;YACf,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE;gBAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAW,CAAC;gBAClE,MAAM,WAAW,GAAG,SAAS,KAAK,QAAQ;oBACzC,CAAC,CAAC,EAAE,GAAG,IAAA,+BAAuB,GAAE,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE;oBACnE,CAAC,CAAC,EAAE,GAAG,IAAA,kCAA0B,GAAE,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;gBAExE,UAAU,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,WAAqC;oBAC3C,UAAU,EAAE,CAAC;iBACb,CAAC,CAAC;aACH;iBAAM;gBACN,MAAM,KAAK,CAAC;aACZ;SACD;KACD;IAED,OAAO,CAAC,UAAU,CAAC,CAAC;AACrB,CAAC;AAvCD,0BAuCC"}

package/dist/nodes/ServiceM8JobCreation/helpers/addressUtils.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Address Building and Matching Utilities
+ */
+import type { AddressParts, AddressMatchResult } from '../types/index';
+/**
+ * Join non-empty strings with a separator
+ */
+export declare function joinNonEmpty(parts: (string | undefined | null)[], separator?: string): string;
+/**
+ * Build a concatenated address string from parts
+ */
+export declare function buildAddressString(parts: AddressParts): string;
+/**
+ * Normalize a string for matching (lowercase, remove special chars)
+ */
+export declare function normalizeForMatching(str: string | undefined | null): string;
+/**
+ * Light normalization (lowercase, trim, but keep spaces)
+ */
+export declare function lightNormalize(str: string | undefined | null): string;
+/**
+ * Compare two addresses and return match quality
+ * - 'exact': street + (postcode OR city) match
+ * - 'near': postcode matches OR street contains/starts with
+ * - 'none': no meaningful match
+ */
+export declare function matchAddresses(input: AddressParts, existing: {
+    address_street?: string;
+    address_city?: string;
+    address_postcode?: string;
+}): AddressMatchResult;
+/**
+ * Parse address parts from a node's fixedCollection input
+ */
+export declare function parseAddressFromInput(addressData: {
+    address?: Array<{
+        street?: string;
+        city?: string;
+        state?: string;
+        postcode?: string;
+        country?: string;
+    }>;
+} | undefined): AddressParts;
+/**
+ * Check if an address has any meaningful content
+ */
+export declare function hasAddressContent(parts: AddressParts): boolean;
+/**
+ * Australian states for validation
+ */
+export declare const AUSTRALIAN_STATES: readonly ["NSW", "VIC", "QLD", "WA", "SA", "TAS", "ACT", "NT"];
+export type AustralianState = (typeof AUSTRALIAN_STATES)[number];
+/**
+ * Validate an Australian postcode format
+ */
+export declare function isValidAustralianPostcode(postcode: string | undefined | null): boolean;

package/dist/nodes/ServiceM8JobCreation/helpers/addressUtils.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Address Building and Matching Utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidAustralianPostcode = exports.AUSTRALIAN_STATES = exports.hasAddressContent = exports.parseAddressFromInput = exports.matchAddresses = exports.lightNormalize = exports.normalizeForMatching = exports.buildAddressString = exports.joinNonEmpty = void 0;
+/**
+ * Join non-empty strings with a separator
+ */
+function joinNonEmpty(parts, separator = ', ') {
+    return parts
+        .filter((p) => p != null && String(p).trim() !== '')
+        .map((p) => String(p).trim())
+        .join(separator);
+}
+exports.joinNonEmpty = joinNonEmpty;
+/**
+ * Build a concatenated address string from parts
+ */
+function buildAddressString(parts) {
+    return joinNonEmpty([
+        parts.street,
+        parts.city,
+        parts.state,
+        parts.postcode,
+        parts.country,
+    ]);
+}
+exports.buildAddressString = buildAddressString;
+/**
+ * Normalize a string for matching (lowercase, remove special chars)
+ */
+function normalizeForMatching(str) {
+    return (str || '').toLowerCase().trim().replace(/[^a-z0-9]/g, '');
+}
+exports.normalizeForMatching = normalizeForMatching;
+/**
+ * Light normalization (lowercase, trim, but keep spaces)
+ */
+function lightNormalize(str) {
+    return (str || '').toLowerCase().trim();
+}
+exports.lightNormalize = lightNormalize;
+/**
+ * Compare two addresses and return match quality
+ * - 'exact': street + (postcode OR city) match
+ * - 'near': postcode matches OR street contains/starts with
+ * - 'none': no meaningful match
+ */
+function matchAddresses(input, existing) {
+    const inputStreet = normalizeForMatching(input.street);
+    const inputPostcode = normalizeForMatching(input.postcode);
+    const inputCity = normalizeForMatching(input.city);
+    const existingStreet = normalizeForMatching(existing.address_street);
+    const existingPostcode = normalizeForMatching(existing.address_postcode);
+    const existingCity = normalizeForMatching(existing.address_city);
+    // Exact: street matches AND (postcode OR city matches)
+    if (inputStreet && existingStreet && inputStreet === existingStreet) {
+        if ((inputPostcode && existingPostcode && inputPostcode === existingPostcode) ||
+            (inputCity && existingCity && inputCity === existingCity)) {
+            return 'exact';
+        }
+    }
+    // Near-exact: postcode matches
+    if (inputPostcode && existingPostcode && inputPostcode === existingPostcode) {
+        return 'near';
+    }
+    // Near-exact: street contains or starts with
+    if (inputStreet &&
+        existingStreet &&
+        (existingStreet.includes(inputStreet) || inputStreet.includes(existingStreet))) {
+        return 'near';
+    }
+    return 'none';
+}
+exports.matchAddresses = matchAddresses;
+/**
+ * Parse address parts from a node's fixedCollection input
+ */
+function parseAddressFromInput(addressData) {
+    var _a;
+    const addr = (_a = addressData === null || addressData === void 0 ? void 0 : addressData.address) === null || _a === void 0 ? void 0 : _a[0];
+    return {
+        street: (addr === null || addr === void 0 ? void 0 : addr.street) || '',
+        city: (addr === null || addr === void 0 ? void 0 : addr.city) || '',
+        state: (addr === null || addr === void 0 ? void 0 : addr.state) || '',
+        postcode: (addr === null || addr === void 0 ? void 0 : addr.postcode) || '',
+        country: (addr === null || addr === void 0 ? void 0 : addr.country) || 'Australia',
+    };
+}
+exports.parseAddressFromInput = parseAddressFromInput;
+/**
+ * Check if an address has any meaningful content
+ */
+function hasAddressContent(parts) {
+    return !!(parts.street ||
+        parts.city ||
+        parts.state ||
+        parts.postcode);
+}
+exports.hasAddressContent = hasAddressContent;
+/**
+ * Australian states for validation
+ */
+exports.AUSTRALIAN_STATES = [
+    'NSW',
+    'VIC',
+    'QLD',
+    'WA',
+    'SA',
+    'TAS',
+    'ACT',
+    'NT',
+];
+/**
+ * Validate an Australian postcode format
+ */
+function isValidAustralianPostcode(postcode) {
+    if (!postcode)
+        return false;
+    return /^\d{4}$/.test(postcode.trim());
+}
+exports.isValidAustralianPostcode = isValidAustralianPostcode;
+//# sourceMappingURL=addressUtils.js.map

package/dist/nodes/ServiceM8JobCreation/helpers/addressUtils.js.map

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

package/dist/nodes/ServiceM8JobCreation/helpers/api.d.ts

@@ -0,0 +1,180 @@
+/**
+ * ServiceM8 API Helper Functions
+ */
+/// <reference types="node" />
+/// <reference types="node" />
+import type { IExecuteFunctions, ILoadOptionsFunctions, IHttpRequestMethods } from 'n8n-workflow';
+export interface ServiceM8RequestOptions {
+    method?: IHttpRequestMethods;
+    endpoint: string;
+    body?: Record<string, unknown>;
+    query?: Record<string, string>;
+    returnFullResponse?: boolean;
+}
+/**
+ * Make an authenticated request to the ServiceM8 API
+ */
+export declare function serviceM8Request(context: IExecuteFunctions | ILoadOptionsFunctions, options: ServiceM8RequestOptions): Promise<unknown>;
+/**
+ * Extract UUID from response headers (for POST requests that return x-record-uuid)
+ */
+export declare function extractUuidFromResponse(response: unknown): string | null;
+/**
+ * Build OData $filter query parameter
+ */
+export interface FilterCondition {
+    field: string;
+    operator: 'eq' | 'ne' | 'gt' | 'lt' | 'ge' | 'le';
+    value: string | number;
+}
+export declare function buildODataFilter(conditions: FilterCondition[]): string;
+/**
+ * Escape single quotes for OData filter values
+ */
+export declare function escapeOData(value: string): string;
+/**
+ * Parse API response to ensure it's always an array
+ */
+export declare function parseArrayResponse<T>(response: unknown): T[];
+/**
+ * Create a company (client) in ServiceM8
+ */
+export declare function createClient(context: IExecuteFunctions, data: {
+    name: string;
+    is_individual: number;
+    address?: string;
+    address_street?: string;
+    address_city?: string;
+    address_state?: string;
+    address_postcode?: string;
+    address_country?: string;
+}): Promise<string>;
+/**
+ * Create a company contact in ServiceM8
+ */
+export declare function createCompanyContact(context: IExecuteFunctions, data: {
+    company_uuid: string;
+    first: string;
+    last: string;
+    email?: string;
+    phone?: string;
+    mobile?: string;
+    type?: string;
+}): Promise<string>;
+/**
+ * Create a job in ServiceM8
+ */
+export declare function createJob(context: IExecuteFunctions, data: {
+    company_uuid: string;
+    status: string;
+    job_address?: string;
+    billing_address?: string;
+    job_description?: string;
+}): Promise<{
+    uuid: string;
+    jobNumber?: string;
+}>;
+/**
+ * Create a job contact in ServiceM8
+ */
+export declare function createJobContact(context: IExecuteFunctions, data: {
+    job_uuid: string;
+    first: string;
+    last: string;
+    email?: string;
+    phone?: string;
+    mobile?: string;
+    is_primary_contact?: boolean;
+}): Promise<string>;
+/**
+ * Update a job (for category assignment)
+ */
+export declare function updateJob(context: IExecuteFunctions, jobUuid: string, data: Record<string, unknown>): Promise<void>;
+/**
+ * Assign badges to a job by updating the job's badges field
+ * The badges field is a JSON array string of badge UUIDs
+ */
+export declare function assignBadgesToJob(context: IExecuteFunctions, jobUuid: string, badgeUuids: string[]): Promise<void>;
+/**
+ * Assign a job to a queue by updating the job's queue_uuid field
+ */
+export declare function assignJobToQueue(context: IExecuteFunctions, jobUuid: string, queueUuid: string): Promise<void>;
+/**
+ * Send SMS notification via ServiceM8
+ */
+export declare function sendSms(context: IExecuteFunctions, to: string, message: string, jobUuid?: string): Promise<void>;
+export interface EmailAttachment {
+    uuid: string;
+    fileName: string;
+}
+export interface SendEmailOptions {
+    to: string;
+    subject: string;
+    htmlBody?: string;
+    textBody?: string;
+    jobUuid?: string;
+    attachmentUuids?: string[];
+}
+/**
+ * Send email notification via ServiceM8
+ * Supports both HTML and plain text format, plus attachments
+ */
+export declare function sendEmail(context: IExecuteFunctions, options: SendEmailOptions): Promise<void>;
+/**
+ * Legacy sendEmail function for backward compatibility
+ * @deprecated Use sendEmail with options object instead
+ */
+export declare function sendEmailLegacy(context: IExecuteFunctions, to: string, subject: string, htmlBody: string, jobUuid?: string): Promise<void>;
+/**
+ * Upload binary data as a job attachment and return the UUID
+ * This can be used to attach files to emails
+ */
+export declare function uploadBinaryAsAttachment(context: IExecuteFunctions, itemIndex: number, jobUuid: string, binaryPropertyName: string): Promise<EmailAttachment | null>;
+/**
+ * Delete a job contact
+ */
+export declare function deleteJobContact(context: IExecuteFunctions, contactUuid: string): Promise<void>;
+/**
+ * Get job details
+ */
+export declare function getJob(context: IExecuteFunctions, jobUuid: string): Promise<Record<string, unknown>>;
+/**
+ * Create a job note
+ * Uses /api_1.0/note.json with related_object and related_object_uuid
+ */
+export declare function createJobNote(context: IExecuteFunctions, jobUuid: string, note: string): Promise<string>;
+/**
+ * Find badge UUID by name (case-insensitive)
+ */
+export declare function findBadgeByName(badges: Array<{
+    uuid: string;
+    name: string;
+}>, searchName: string): {
+    uuid: string;
+    name: string;
+} | null;
+/**
+ * Find category UUID by name (case-insensitive)
+ */
+export declare function findCategoryByName(categories: Array<{
+    uuid: string;
+    name: string;
+}>, searchName: string): {
+    uuid: string;
+    name: string;
+} | null;
+/**
+ * Find queue UUID by name (case-insensitive)
+ */
+export declare function findQueueByName(queues: Array<{
+    uuid: string;
+    name: string;
+}>, searchName: string): {
+    uuid: string;
+    name: string;
+} | null;
+/**
+ * Upload binary content to an attachment
+ * Uses multipart/form-data format
+ */
+export declare function uploadAttachmentBinary(context: IExecuteFunctions, attachmentUuid: string, buffer: Buffer, fileName: string, mimeType: string): Promise<void>;