@wesell/n8n-nodes-confirmx 0.1.0

package/nodes/ConfirmX/ConfirmXConversation.node.js

@@ -0,0 +1,266 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmXConversation = void 0;
+const http_1 = require("../../transports/http");
+class ConfirmXConversation {
+    constructor() {
+        this.description = {
+            displayName: 'ConfirmX Conversation',
+            name: 'confirmXConversation',
+            icon: 'file:confirmx.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Read and manage WhatsApp conversations: list, view, mark read, change status, assign to a teammate.',
+            defaults: { name: 'ConfirmX Conversation' },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [{ name: 'confirmXApi', required: true }],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'List',
+                            value: 'list',
+                            action: 'List conversations',
+                            description: 'List recent WhatsApp conversations for the org. Use to discover open conversations, find a conversation by contact phone or name, or check unread counts. Supports `status` filter (open/resolved/archived), free-text `q` search, and tag CSV. Returns up to 100 per page with `messages[0]` as the latest preview.',
+                        },
+                        {
+                            name: 'Get',
+                            value: 'get',
+                            action: 'Get conversation',
+                            description: 'Fetch a single conversation by id. Use when you already have a `conversationId` (from a webhook, from List, or from an upstream node) and need the contact, account, and latest message. Requires `conversationId`.',
+                        },
+                        {
+                            name: 'Mark Read',
+                            value: 'markRead',
+                            action: 'Mark as read',
+                            description: 'Zero the unread counter on a conversation. Use after a human or AI finishes handling the thread so the badge clears. Requires `conversationId`.',
+                        },
+                        {
+                            name: 'Update Status',
+                            value: 'updateStatus',
+                            action: 'Update status',
+                            description: 'Set a conversation\'s status (`open`, `resolved`, `archived`). Use `resolved` when the issue is closed and `archived` to remove from default views. Requires `conversationId` and `status`.',
+                        },
+                        {
+                            name: 'Assign',
+                            value: 'assign',
+                            action: 'Assign to user',
+                            description: 'Assign a conversation to a teammate by `assignToUserId` (or pass `null` to unassign). Requires `conversationId`. Returns the updated conversation with the `assignedTo` relation.',
+                        },
+                    ],
+                    default: 'list',
+                },
+                // --- Account (optional for list, not needed for the others) ---
+                {
+                    displayName: 'Account',
+                    name: 'accountId',
+                    type: 'resourceLocator',
+                    default: { mode: 'list', value: '' },
+                    displayOptions: { show: { operation: ['list'] } },
+                    modes: [
+                        { displayName: 'From List', name: 'list', type: 'list', typeOptions: { searchable: true } },
+                        { displayName: 'By ID', name: 'id', type: 'string' },
+                    ],
+                    typeOptions: { loadOptionsMethod: 'getAccounts' },
+                    description: 'Restrict list to one WhatsApp account (optional — leave empty for org-wide)',
+                },
+                // --- List filters ---
+                {
+                    displayName: 'Status',
+                    name: 'status',
+                    type: 'options',
+                    default: '',
+                    options: [
+                        { name: 'All', value: '' },
+                        { name: 'Open', value: 'open' },
+                        { name: 'Resolved', value: 'resolved' },
+                        { name: 'Archived', value: 'archived' },
+                    ],
+                    displayOptions: { show: { operation: ['list'] } },
+                },
+                {
+                    displayName: 'Search',
+                    name: 'q',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { operation: ['list'] } },
+                    description: 'Free-text search over contact phone + name + last message body',
+                },
+                {
+                    displayName: 'Sort By',
+                    name: 'sortBy',
+                    type: 'options',
+                    default: 'lastMessageAt',
+                    options: [
+                        { name: 'Last Message At', value: 'lastMessageAt' },
+                        { name: 'Unread Count', value: 'unreadCount' },
+                        { name: 'Created At', value: 'createdAt' },
+                    ],
+                    displayOptions: { show: { operation: ['list'] } },
+                },
+                {
+                    displayName: 'Sort Order',
+                    name: 'sortOrder',
+                    type: 'options',
+                    default: 'desc',
+                    options: [
+                        { name: 'Descending', value: 'desc' },
+                        { name: 'Ascending', value: 'asc' },
+                    ],
+                    displayOptions: { show: { operation: ['list'] } },
+                },
+                {
+                    displayName: 'Page',
+                    name: 'page',
+                    type: 'number',
+                    default: 1,
+                    typeOptions: { minValue: 1 },
+                    displayOptions: { show: { operation: ['list'] } },
+                },
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    default: false,
+                    displayOptions: { show: { operation: ['list'] } },
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    default: 30,
+                    typeOptions: { minValue: 1, maxValue: 100 },
+                    displayOptions: { show: { operation: ['list'], returnAll: [false] } },
+                },
+                // --- Conversation ID (get / markRead / updateStatus / assign) ---
+                {
+                    displayName: 'Conversation ID',
+                    name: 'conversationId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { operation: ['get', 'markRead', 'updateStatus', 'assign'] } },
+                },
+                // --- Update Status ---
+                {
+                    displayName: 'Status',
+                    name: 'newStatus',
+                    type: 'options',
+                    default: 'open',
+                    options: [
+                        { name: 'Open', value: 'open' },
+                        { name: 'Resolved', value: 'resolved' },
+                        { name: 'Archived', value: 'archived' },
+                    ],
+                    displayOptions: { show: { operation: ['updateStatus'] } },
+                },
+                // --- Assign ---
+                {
+                    displayName: 'Assign To User ID',
+                    name: 'assignToUserId',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { operation: ['assign'] } },
+                    description: 'User ID to assign to. Leave empty or pass "null" (string) to unassign.',
+                },
+            ],
+            usableAsTool: true,
+        };
+        this.methods = {
+            loadOptions: {
+                async getAccounts() {
+                    return await (0, http_1.loadAccountOptions)(this);
+                },
+            },
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resolveAccountId = (i) => {
+            const v = this.getNodeParameter('accountId', i, '');
+            if (!v)
+                return undefined;
+            return typeof v === 'string' ? v : v?.value;
+        };
+        for (let i = 0; i < items.length; i++) {
+            const operation = this.getNodeParameter('operation', i);
+            if (operation === 'list') {
+                const qs = {};
+                const accountId = resolveAccountId(i);
+                if (accountId)
+                    qs.accountId = accountId;
+                const status = this.getNodeParameter('status', i, '');
+                if (status)
+                    qs.status = status;
+                const q = this.getNodeParameter('q', i, '').trim();
+                if (q)
+                    qs.q = q;
+                qs.sortBy = this.getNodeParameter('sortBy', i);
+                qs.sortOrder = this.getNodeParameter('sortOrder', i);
+                const returnAll = this.getNodeParameter('returnAll', i);
+                const limit = this.getNodeParameter('limit', i) || 30;
+                qs.limit = returnAll ? 100 : limit;
+                qs.page = this.getNodeParameter('page', i);
+                const res = await (0, http_1.confirmxApiRequest)(this, {
+                    method: 'GET',
+                    endpoint: '/conversations',
+                    qs,
+                });
+                const list = res.conversations || [];
+                const sliced = returnAll ? list : list.slice(0, limit);
+                returnData.push(...sliced.map((c) => ({ json: c })));
+            }
+            else if (operation === 'get') {
+                const id = this.getNodeParameter('conversationId', i);
+                const res = await (0, http_1.confirmxApiRequest)(this, {
+                    method: 'GET',
+                    endpoint: `/conversations/${id}`,
+                });
+                returnData.push({ json: res.conversation });
+            }
+            else if (operation === 'markRead') {
+                const id = this.getNodeParameter('conversationId', i);
+                const res = await (0, http_1.confirmxApiRequest)(this, {
+                    method: 'POST',
+                    endpoint: `/conversations/${id}/read`,
+                });
+                returnData.push({ json: { conversationId: id, ...res } });
+            }
+            else if (operation === 'updateStatus') {
+                const id = this.getNodeParameter('conversationId', i);
+                const status = this.getNodeParameter('newStatus', i);
+                const res = await (0, http_1.confirmxApiRequest)(this, {
+                    method: 'PATCH',
+                    endpoint: `/conversations/${id}/status`,
+                    body: { status },
+                });
+                returnData.push({ json: res.conversation });
+            }
+            else if (operation === 'assign') {
+                const id = this.getNodeParameter('conversationId', i);
+                let raw = this.getNodeParameter('assignToUserId', i, '').trim();
+                let assignToUserId;
+                if (!raw || raw.toLowerCase() === 'null')
+                    assignToUserId = null;
+                else
+                    assignToUserId = raw;
+                const res = await (0, http_1.confirmxApiRequest)(this, {
+                    method: 'PATCH',
+                    endpoint: `/conversations/${id}/assign`,
+                    body: { assignToUserId },
+                });
+                returnData.push({ json: res.conversation });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.ConfirmXConversation = ConfirmXConversation;
+//# sourceMappingURL=ConfirmXConversation.node.js.map

package/nodes/ConfirmX/ConfirmXConversation.node.js.map

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

package/nodes/ConfirmX/ConfirmXConversation.node.ts

@@ -0,0 +1,263 @@
+import type { INodeType, INodeTypeDescription } from 'n8n-workflow'
+import { confirmxApiRequest, loadAccountOptions } from '../../transports/http'
+
+export class ConfirmXConversation implements INodeType {
+  description: INodeTypeDescription = {
+    displayName: 'ConfirmX Conversation',
+    name: 'confirmXConversation',
+    icon: 'file:confirmx.svg',
+    group: ['transform'],
+    version: 1,
+    subtitle: '={{$parameter["operation"]}}',
+    description:
+      'Read and manage WhatsApp conversations: list, view, mark read, change status, assign to a teammate.',
+    defaults: { name: 'ConfirmX Conversation' },
+    inputs: ['main'],
+    outputs: ['main'],
+    credentials: [{ name: 'confirmXApi', required: true }],
+    properties: [
+      {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        options: [
+          {
+            name: 'List',
+            value: 'list',
+            action: 'List conversations',
+            description:
+              'List recent WhatsApp conversations for the org. Use to discover open conversations, find a conversation by contact phone or name, or check unread counts. Supports `status` filter (open/resolved/archived), free-text `q` search, and tag CSV. Returns up to 100 per page with `messages[0]` as the latest preview.',
+          },
+          {
+            name: 'Get',
+            value: 'get',
+            action: 'Get conversation',
+            description:
+              'Fetch a single conversation by id. Use when you already have a `conversationId` (from a webhook, from List, or from an upstream node) and need the contact, account, and latest message. Requires `conversationId`.',
+          },
+          {
+            name: 'Mark Read',
+            value: 'markRead',
+            action: 'Mark as read',
+            description:
+              'Zero the unread counter on a conversation. Use after a human or AI finishes handling the thread so the badge clears. Requires `conversationId`.',
+          },
+          {
+            name: 'Update Status',
+            value: 'updateStatus',
+            action: 'Update status',
+            description:
+              'Set a conversation\'s status (`open`, `resolved`, `archived`). Use `resolved` when the issue is closed and `archived` to remove from default views. Requires `conversationId` and `status`.',
+          },
+          {
+            name: 'Assign',
+            value: 'assign',
+            action: 'Assign to user',
+            description:
+              'Assign a conversation to a teammate by `assignToUserId` (or pass `null` to unassign). Requires `conversationId`. Returns the updated conversation with the `assignedTo` relation.',
+          },
+        ],
+        default: 'list',
+      },
+      // --- Account (optional for list, not needed for the others) ---
+      {
+        displayName: 'Account',
+        name: 'accountId',
+        type: 'resourceLocator',
+        default: { mode: 'list', value: '' },
+        displayOptions: { show: { operation: ['list'] } },
+        modes: [
+          { displayName: 'From List', name: 'list', type: 'list', typeOptions: { searchable: true } },
+          { displayName: 'By ID', name: 'id', type: 'string' },
+        ],
+        typeOptions: { loadOptionsMethod: 'getAccounts' },
+        description: 'Restrict list to one WhatsApp account (optional — leave empty for org-wide)',
+      },
+      // --- List filters ---
+      {
+        displayName: 'Status',
+        name: 'status',
+        type: 'options',
+        default: '',
+        options: [
+          { name: 'All', value: '' },
+          { name: 'Open', value: 'open' },
+          { name: 'Resolved', value: 'resolved' },
+          { name: 'Archived', value: 'archived' },
+        ],
+        displayOptions: { show: { operation: ['list'] } },
+      },
+      {
+        displayName: 'Search',
+        name: 'q',
+        type: 'string',
+        default: '',
+        displayOptions: { show: { operation: ['list'] } },
+        description: 'Free-text search over contact phone + name + last message body',
+      },
+      {
+        displayName: 'Sort By',
+        name: 'sortBy',
+        type: 'options',
+        default: 'lastMessageAt',
+        options: [
+          { name: 'Last Message At', value: 'lastMessageAt' },
+          { name: 'Unread Count', value: 'unreadCount' },
+          { name: 'Created At', value: 'createdAt' },
+        ],
+        displayOptions: { show: { operation: ['list'] } },
+      },
+      {
+        displayName: 'Sort Order',
+        name: 'sortOrder',
+        type: 'options',
+        default: 'desc',
+        options: [
+          { name: 'Descending', value: 'desc' },
+          { name: 'Ascending', value: 'asc' },
+        ],
+        displayOptions: { show: { operation: ['list'] } },
+      },
+      {
+        displayName: 'Page',
+        name: 'page',
+        type: 'number',
+        default: 1,
+        typeOptions: { minValue: 1 },
+        displayOptions: { show: { operation: ['list'] } },
+      },
+      {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        default: false,
+        displayOptions: { show: { operation: ['list'] } },
+      },
+      {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        default: 30,
+        typeOptions: { minValue: 1, maxValue: 100 },
+        displayOptions: { show: { operation: ['list'], returnAll: [false] } },
+      },
+      // --- Conversation ID (get / markRead / updateStatus / assign) ---
+      {
+        displayName: 'Conversation ID',
+        name: 'conversationId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { operation: ['get', 'markRead', 'updateStatus', 'assign'] } },
+      },
+      // --- Update Status ---
+      {
+        displayName: 'Status',
+        name: 'newStatus',
+        type: 'options',
+        default: 'open',
+        options: [
+          { name: 'Open', value: 'open' },
+          { name: 'Resolved', value: 'resolved' },
+          { name: 'Archived', value: 'archived' },
+        ],
+        displayOptions: { show: { operation: ['updateStatus'] } },
+      },
+      // --- Assign ---
+      {
+        displayName: 'Assign To User ID',
+        name: 'assignToUserId',
+        type: 'string',
+        default: '',
+        displayOptions: { show: { operation: ['assign'] } },
+        description: 'User ID to assign to. Leave empty or pass "null" (string) to unassign.',
+      },
+    ],
+    usableAsTool: true,
+  }
+
+  methods = {
+    loadOptions: {
+      async getAccounts(this: any) {
+        return await loadAccountOptions(this)
+      },
+    },
+  }
+
+  async execute(this: any) {
+    const items = this.getInputData()
+    const returnData: any[] = []
+    const resolveAccountId = (i: number) => {
+      const v = this.getNodeParameter('accountId', i, '') as any
+      if (!v) return undefined
+      return typeof v === 'string' ? v : v?.value
+    }
+
+    for (let i = 0; i < items.length; i++) {
+      const operation = this.getNodeParameter('operation', i) as string
+
+      if (operation === 'list') {
+        const qs: Record<string, any> = {}
+        const accountId = resolveAccountId(i)
+        if (accountId) qs.accountId = accountId
+        const status = this.getNodeParameter('status', i, '') as string
+        if (status) qs.status = status
+        const q = (this.getNodeParameter('q', i, '') as string).trim()
+        if (q) qs.q = q
+        qs.sortBy = this.getNodeParameter('sortBy', i) as string
+        qs.sortOrder = this.getNodeParameter('sortOrder', i) as string
+        const returnAll = this.getNodeParameter('returnAll', i) as boolean
+        const limit = (this.getNodeParameter('limit', i) as number) || 30
+        qs.limit = returnAll ? 100 : limit
+        qs.page = this.getNodeParameter('page', i) as number
+
+        const res = await confirmxApiRequest<{ conversations: any[] }>(this, {
+          method: 'GET',
+          endpoint: '/conversations',
+          qs,
+        })
+        const list = res.conversations || []
+        const sliced = returnAll ? list : list.slice(0, limit)
+        returnData.push(...sliced.map((c) => ({ json: c })))
+      } else if (operation === 'get') {
+        const id = this.getNodeParameter('conversationId', i) as string
+        const res = await confirmxApiRequest<{ conversation: any }>(this, {
+          method: 'GET',
+          endpoint: `/conversations/${id}`,
+        })
+        returnData.push({ json: res.conversation })
+      } else if (operation === 'markRead') {
+        const id = this.getNodeParameter('conversationId', i) as string
+        const res = await confirmxApiRequest<any>(this, {
+          method: 'POST',
+          endpoint: `/conversations/${id}/read`,
+        })
+        returnData.push({ json: { conversationId: id, ...res } })
+      } else if (operation === 'updateStatus') {
+        const id = this.getNodeParameter('conversationId', i) as string
+        const status = this.getNodeParameter('newStatus', i) as string
+        const res = await confirmxApiRequest<{ conversation: any }>(this, {
+          method: 'PATCH',
+          endpoint: `/conversations/${id}/status`,
+          body: { status },
+        })
+        returnData.push({ json: res.conversation })
+      } else if (operation === 'assign') {
+        const id = this.getNodeParameter('conversationId', i) as string
+        let raw = (this.getNodeParameter('assignToUserId', i, '') as string).trim()
+        let assignToUserId: string | null
+        if (!raw || raw.toLowerCase() === 'null') assignToUserId = null
+        else assignToUserId = raw
+        const res = await confirmxApiRequest<{ conversation: any }>(this, {
+          method: 'PATCH',
+          endpoint: `/conversations/${id}/assign`,
+          body: { assignToUserId },
+        })
+        returnData.push({ json: res.conversation })
+      }
+    }
+
+    return [returnData]
+  }
+}

package/nodes/ConfirmX/ConfirmXMessage.node.d.ts

@@ -0,0 +1,13 @@
+import type { INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class ConfirmXMessage implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getAccounts(this: any): Promise<{
+                name: string;
+                value: string;
+            }[]>;
+        };
+    };
+    execute(this: any): Promise<any[][]>;
+}