n8n-nodes-servicem8-jobcreation 1.0.0

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

@@ -0,0 +1,418 @@
+"use strict";
+/**
+ * ServiceM8 API Helper Functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadAttachmentBinary = exports.findQueueByName = exports.findCategoryByName = exports.findBadgeByName = exports.createJobNote = exports.getJob = exports.deleteJobContact = exports.uploadBinaryAsAttachment = exports.sendEmailLegacy = exports.sendEmail = exports.sendSms = exports.assignJobToQueue = exports.assignBadgesToJob = exports.updateJob = exports.createJobContact = exports.createJob = exports.createCompanyContact = exports.createClient = exports.parseArrayResponse = exports.escapeOData = exports.buildODataFilter = exports.extractUuidFromResponse = exports.serviceM8Request = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const BASE_URL = 'https://api.servicem8.com';
+/**
+ * Make an authenticated request to the ServiceM8 API
+ */
+async function serviceM8Request(context, options) {
+    const { method = 'GET', endpoint, body, query, returnFullResponse = false } = options;
+    const requestOptions = {
+        method,
+        url: `${BASE_URL}${endpoint}`,
+        headers: {
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+        },
+        json: true,
+        returnFullResponse,
+    };
+    if (body) {
+        requestOptions.body = body;
+    }
+    if (query) {
+        requestOptions.qs = query;
+    }
+    try {
+        const response = await context.helpers.httpRequestWithAuthentication.call(context, 'serviceM8Api', requestOptions);
+        return response;
+    }
+    catch (error) {
+        const err = error;
+        throw new n8n_workflow_1.NodeApiError(context.getNode(), { message: err.message }, {
+            message: `ServiceM8 API error on ${endpoint}`,
+        });
+    }
+}
+exports.serviceM8Request = serviceM8Request;
+/**
+ * Extract UUID from response headers (for POST requests that return x-record-uuid)
+ */
+function extractUuidFromResponse(response) {
+    var _a;
+    if (!response || typeof response !== 'object') {
+        return null;
+    }
+    // Full response with headers
+    const fullResponse = response;
+    if ((_a = fullResponse.headers) === null || _a === void 0 ? void 0 : _a['x-record-uuid']) {
+        return fullResponse.headers['x-record-uuid'];
+    }
+    // Direct response with uuid field
+    const directResponse = response;
+    if (directResponse.uuid) {
+        return directResponse.uuid;
+    }
+    return null;
+}
+exports.extractUuidFromResponse = extractUuidFromResponse;
+function buildODataFilter(conditions) {
+    return conditions
+        .map((c) => {
+        const value = typeof c.value === 'string' ? `'${escapeOData(c.value)}'` : c.value;
+        return `${c.field} ${c.operator} ${value}`;
+    })
+        .join(' and ');
+}
+exports.buildODataFilter = buildODataFilter;
+/**
+ * Escape single quotes for OData filter values
+ */
+function escapeOData(value) {
+    return value.replace(/'/g, "''");
+}
+exports.escapeOData = escapeOData;
+/**
+ * Parse API response to ensure it's always an array
+ */
+function parseArrayResponse(response) {
+    if (Array.isArray(response)) {
+        return response;
+    }
+    if (response && typeof response === 'object' && 'uuid' in response) {
+        return [response];
+    }
+    return [];
+}
+exports.parseArrayResponse = parseArrayResponse;
+/**
+ * Create a company (client) in ServiceM8
+ */
+async function createClient(context, data) {
+    const response = await serviceM8Request(context, {
+        method: 'POST',
+        endpoint: '/api_1.0/company.json',
+        body: {
+            ...data,
+            active: 1,
+        },
+        returnFullResponse: true,
+    });
+    const uuid = extractUuidFromResponse(response);
+    if (!uuid) {
+        throw new Error('Failed to get UUID from client creation response');
+    }
+    return uuid;
+}
+exports.createClient = createClient;
+/**
+ * Create a company contact in ServiceM8
+ */
+async function createCompanyContact(context, data) {
+    const response = await serviceM8Request(context, {
+        method: 'POST',
+        endpoint: '/api_1.0/companycontact.json',
+        body: {
+            ...data,
+            active: 1,
+            type: data.type || 'BILLING',
+        },
+        returnFullResponse: true,
+    });
+    const uuid = extractUuidFromResponse(response);
+    if (!uuid) {
+        throw new Error('Failed to get UUID from contact creation response');
+    }
+    return uuid;
+}
+exports.createCompanyContact = createCompanyContact;
+/**
+ * Create a job in ServiceM8
+ */
+async function createJob(context, data) {
+    const response = await serviceM8Request(context, {
+        method: 'POST',
+        endpoint: '/api_1.0/job.json',
+        body: {
+            ...data,
+            active: 1,
+        },
+        returnFullResponse: true,
+    });
+    const uuid = extractUuidFromResponse(response);
+    if (!uuid) {
+        throw new Error('Failed to get UUID from job creation response');
+    }
+    return { uuid };
+}
+exports.createJob = createJob;
+/**
+ * Create a job contact in ServiceM8
+ */
+async function createJobContact(context, data) {
+    var _a;
+    const response = await serviceM8Request(context, {
+        method: 'POST',
+        endpoint: '/api_1.0/jobcontact.json',
+        body: {
+            ...data,
+            active: 1,
+            type: 'JOB',
+            is_primary_contact: (_a = data.is_primary_contact) !== null && _a !== void 0 ? _a : true,
+        },
+        returnFullResponse: true,
+    });
+    const uuid = extractUuidFromResponse(response);
+    if (!uuid) {
+        throw new Error('Failed to get UUID from job contact creation response');
+    }
+    return uuid;
+}
+exports.createJobContact = createJobContact;
+/**
+ * Update a job (for category assignment)
+ */
+async function updateJob(context, jobUuid, data) {
+    await serviceM8Request(context, {
+        method: 'POST',
+        endpoint: `/api_1.0/job/${jobUuid}.json`,
+        body: data,
+    });
+}
+exports.updateJob = updateJob;
+/**
+ * Assign badges to a job by updating the job's badges field
+ * The badges field is a JSON array string of badge UUIDs
+ */
+async function assignBadgesToJob(context, jobUuid, badgeUuids) {
+    // ServiceM8 stores badges as a JSON array string in the job record
+    const badgesJson = JSON.stringify(badgeUuids);
+    await serviceM8Request(context, {
+        method: 'POST',
+        endpoint: `/api_1.0/job/${jobUuid}.json`,
+        body: {
+            badges: badgesJson,
+        },
+    });
+}
+exports.assignBadgesToJob = assignBadgesToJob;
+/**
+ * Assign a job to a queue by updating the job's queue_uuid field
+ */
+async function assignJobToQueue(context, jobUuid, queueUuid) {
+    await serviceM8Request(context, {
+        method: 'POST',
+        endpoint: `/api_1.0/job/${jobUuid}.json`,
+        body: {
+            queue_uuid: queueUuid,
+        },
+    });
+}
+exports.assignJobToQueue = assignJobToQueue;
+/**
+ * Send SMS notification via ServiceM8
+ */
+async function sendSms(context, to, message, jobUuid) {
+    const body = {
+        to,
+        message,
+    };
+    if (jobUuid) {
+        body.regardingJobUUID = jobUuid;
+    }
+    await serviceM8Request(context, {
+        method: 'POST',
+        endpoint: '/platform_service_sms',
+        body,
+    });
+}
+exports.sendSms = sendSms;
+/**
+ * Send email notification via ServiceM8
+ * Supports both HTML and plain text format, plus attachments
+ */
+async function sendEmail(context, options) {
+    const body = {
+        to: options.to,
+        subject: options.subject,
+    };
+    // Use either HTML or text body
+    if (options.htmlBody) {
+        body.htmlBody = options.htmlBody;
+    }
+    else if (options.textBody) {
+        body.textBody = options.textBody;
+    }
+    if (options.jobUuid) {
+        body.regardingJobUUID = options.jobUuid;
+    }
+    // Add attachments if provided (API expects 'attachments' field)
+    if (options.attachmentUuids && options.attachmentUuids.length > 0) {
+        body.attachments = options.attachmentUuids;
+    }
+    await serviceM8Request(context, {
+        method: 'POST',
+        endpoint: '/platform_service_email',
+        body,
+    });
+}
+exports.sendEmail = sendEmail;
+/**
+ * Legacy sendEmail function for backward compatibility
+ * @deprecated Use sendEmail with options object instead
+ */
+async function sendEmailLegacy(context, to, subject, htmlBody, jobUuid) {
+    await sendEmail(context, {
+        to,
+        subject,
+        htmlBody,
+        jobUuid,
+    });
+}
+exports.sendEmailLegacy = sendEmailLegacy;
+/**
+ * Upload binary data as a job attachment and return the UUID
+ * This can be used to attach files to emails
+ */
+async function uploadBinaryAsAttachment(context, itemIndex, jobUuid, binaryPropertyName) {
+    try {
+        const binaryData = context.helpers.assertBinaryData(itemIndex, binaryPropertyName);
+        const buffer = await context.helpers.getBinaryDataBuffer(itemIndex, binaryPropertyName);
+        const fileName = binaryData.fileName || 'attachment';
+        const mimeType = binaryData.mimeType || 'application/octet-stream';
+        // Determine file extension
+        const extension = fileName.includes('.') ? '.' + fileName.split('.').pop() : '';
+        // Step 1: Create attachment metadata
+        const metadataResponse = await serviceM8Request(context, {
+            method: 'POST',
+            endpoint: '/api_1.0/Attachment.json',
+            body: {
+                related_object: 'job',
+                related_object_uuid: jobUuid,
+                attachment_name: fileName,
+                file_type: extension,
+                active: 1,
+            },
+            returnFullResponse: true,
+        });
+        const attachmentUuid = extractUuidFromResponse(metadataResponse);
+        if (!attachmentUuid) {
+            return null;
+        }
+        // Step 2: Upload binary content
+        await uploadAttachmentBinary(context, attachmentUuid, buffer, fileName, mimeType);
+        return { uuid: attachmentUuid, fileName };
+    }
+    catch {
+        return null;
+    }
+}
+exports.uploadBinaryAsAttachment = uploadBinaryAsAttachment;
+/**
+ * Delete a job contact
+ */
+async function deleteJobContact(context, contactUuid) {
+    await serviceM8Request(context, {
+        method: 'DELETE',
+        endpoint: `/api_1.0/jobcontact/${contactUuid}.json`,
+    });
+}
+exports.deleteJobContact = deleteJobContact;
+/**
+ * Get job details
+ */
+async function getJob(context, jobUuid) {
+    const response = await serviceM8Request(context, {
+        method: 'GET',
+        endpoint: `/api_1.0/job/${jobUuid}.json`,
+    });
+    return response;
+}
+exports.getJob = getJob;
+/**
+ * Create a job note
+ * Uses /api_1.0/note.json with related_object and related_object_uuid
+ */
+async function createJobNote(context, jobUuid, note) {
+    const response = await serviceM8Request(context, {
+        method: 'POST',
+        endpoint: '/api_1.0/note.json',
+        body: {
+            related_object: 'job',
+            related_object_uuid: jobUuid,
+            note,
+        },
+        returnFullResponse: true,
+    });
+    const uuid = extractUuidFromResponse(response);
+    if (!uuid) {
+        throw new Error('Failed to get UUID from job note creation response');
+    }
+    return uuid;
+}
+exports.createJobNote = createJobNote;
+/**
+ * Find badge UUID by name (case-insensitive)
+ */
+function findBadgeByName(badges, searchName) {
+    const normalized = searchName.trim().toLowerCase();
+    return badges.find((b) => b.name.trim().toLowerCase() === normalized) || null;
+}
+exports.findBadgeByName = findBadgeByName;
+/**
+ * Find category UUID by name (case-insensitive)
+ */
+function findCategoryByName(categories, searchName) {
+    const normalized = searchName.trim().toLowerCase();
+    return categories.find((c) => c.name.trim().toLowerCase() === normalized) || null;
+}
+exports.findCategoryByName = findCategoryByName;
+/**
+ * Find queue UUID by name (case-insensitive)
+ */
+function findQueueByName(queues, searchName) {
+    const normalized = searchName.trim().toLowerCase();
+    return queues.find((q) => q.name.trim().toLowerCase() === normalized) || null;
+}
+exports.findQueueByName = findQueueByName;
+/**
+ * Upload binary content to an attachment
+ * Uses multipart/form-data format
+ */
+async function uploadAttachmentBinary(context, attachmentUuid, buffer, fileName, mimeType) {
+    // Create form data boundary
+    const boundary = '----n8nFormBoundary' + Date.now().toString(16);
+    // Build multipart form data manually
+    const formParts = [];
+    // File field
+    formParts.push(Buffer.from(`--${boundary}\r\n`));
+    formParts.push(Buffer.from(`Content-Disposition: form-data; name="file"; filename="${fileName}"\r\n`));
+    formParts.push(Buffer.from(`Content-Type: ${mimeType}\r\n\r\n`));
+    formParts.push(buffer);
+    formParts.push(Buffer.from('\r\n'));
+    // End boundary
+    formParts.push(Buffer.from(`--${boundary}--\r\n`));
+    const formBody = Buffer.concat(formParts);
+    try {
+        await context.helpers.httpRequestWithAuthentication.call(context, 'serviceM8Api', {
+            method: 'POST',
+            url: `${BASE_URL}/api_1.0/Attachment/${attachmentUuid}.file`,
+            headers: {
+                'Content-Type': `multipart/form-data; boundary=${boundary}`,
+            },
+            body: formBody,
+        });
+    }
+    catch (error) {
+        const err = error;
+        throw new n8n_workflow_1.NodeApiError(context.getNode(), { message: err.message }, {
+            message: `Failed to upload attachment binary: ${fileName}`,
+        });
+    }
+}
+exports.uploadAttachmentBinary = uploadAttachmentBinary;
+//# sourceMappingURL=api.js.map

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

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

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

@@ -0,0 +1,67 @@
+/**
+ * Client Matching Logic
+ * Implements fuzzy name + address matching for client deduplication
+ */
+import type { ServiceM8Client, AddressParts, NameMatchResult, MatchResult, ClientMatchResult } from '../types/index';
+/**
+ * Compare two names and return match quality
+ * - 'exact': normalized strings are equal
+ * - 'partial': one contains the other, or starts with the other
+ * - 'none': no match
+ */
+export declare function matchClientName(searchName: string, clientName: string): NameMatchResult;
+export type NameFormat = 'firstLast' | 'lastFirst';
+/**
+ * Build a client name from first/last names or business name
+ * For individuals: format depends on nameFormat parameter
+ *   - 'firstLast': "John Smith"
+ *   - 'lastFirst': "Smith, John" (ServiceM8 default)
+ * For businesses: businessName
+ */
+export declare function buildClientName(firstName: string, lastName: string, businessName: string, email: string, nameFormat?: NameFormat): {
+    name: string;
+    isBusiness: boolean;
+};
+/**
+ * Build both possible name formats for matching purposes
+ * Returns both "First Last" and "Last, First" versions
+ */
+export declare function buildBothNameFormats(firstName: string, lastName: string): {
+    firstLast: string;
+    lastFirst: string;
+};
+/**
+ * Find the best matching client from a list
+ * Implements the decision matrix:
+ *
+ * For BUSINESSES:
+ * - Exact name → use existing
+ * - Partial name + exact/near address → use existing (same business, name variant)
+ * - Partial name + no address match → create new
+ *
+ * For INDIVIDUALS:
+ * - Exact name + exact address → use existing
+ * - Exact name + different address → create new (different person, same name)
+ * - Partial name + exact/near address → use existing
+ */
+export declare function findBestMatchingClient(searchName: string, searchAddress: AddressParts, clients: ServiceM8Client[], isBusiness: boolean): ClientMatchResult;
+/**
+ * Determine the action to take based on contact and client matches
+ */
+export interface ActionDecisionInput {
+    contactExists: boolean;
+    existingContactClientUuid: string | null;
+    matchedClient: ServiceM8Client | null;
+    matchType: MatchResult;
+    matchReason: string;
+    isBusiness: boolean;
+    kind: 'business' | 'person';
+}
+export interface ActionDecisionResult {
+    action: 'create_client_and_contact' | 'create_contact_and_job' | 'create_job_only';
+    reason: string;
+    needsClient: boolean;
+    needsContact: boolean;
+    clientUuid: string | null;
+}
+export declare function determineAction(input: ActionDecisionInput): ActionDecisionResult;