@wesell/n8n-nodes-confirmx 0.1.0

package/nodes/ConfirmX/ConfirmXTemplate.node.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmXTemplate = void 0;
+const http_1 = require("../../transports/http");
+class ConfirmXTemplate {
+    constructor() {
+        this.description = {
+            displayName: 'ConfirmX Template',
+            name: 'confirmXTemplate',
+            icon: 'file:confirmx.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Manage Meta WhatsApp message templates — list, get, create, delete. Templates must be approved by Meta before use.',
+            defaults: { name: 'ConfirmX Template' },
+            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 templates',
+                            description: 'List all WhatsApp message templates for an account. Returns every status — APPROVED, PENDING, REJECTED — with full `components[]`. Requires `accountId`. Use when you need to discover which templates exist before sending or auditing.',
+                        },
+                        {
+                            name: 'Get',
+                            value: 'get',
+                            action: 'Get template',
+                            description: 'Fetch a single template by name and language. Returns the live `components[]` and current Meta approval status. Requires `accountId`, `name`, and `language`. Use after a `template.status` webhook to inspect the latest version.',
+                        },
+                        {
+                            name: 'Create',
+                            value: 'create',
+                            action: 'Create template',
+                            description: 'Submit a new template for Meta approval. Returns the new template in PENDING status.',
+                        },
+                        {
+                            name: 'Delete',
+                            value: 'delete',
+                            action: 'Delete template',
+                            description: 'Permanently delete a template.',
+                        },
+                    ],
+                    default: 'list',
+                },
+                {
+                    displayName: 'Account',
+                    name: 'accountId',
+                    type: 'resourceLocator',
+                    default: { mode: 'list', value: '' },
+                    required: true,
+                    displayOptions: {
+                        show: { operation: ['list', 'get', 'create', 'delete'] },
+                    },
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            placeholder: 'Select an account…',
+                            typeOptions: { searchable: true },
+                        },
+                        {
+                            displayName: 'By ID',
+                            name: 'id',
+                            type: 'string',
+                            placeholder: 'acc_…',
+                        },
+                    ],
+                    typeOptions: {
+                        loadOptionsMethod: 'getAccounts',
+                    },
+                    description: 'WhatsApp account to act on',
+                },
+                // --- Get / Delete ---
+                {
+                    displayName: 'Name',
+                    name: 'name',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { operation: ['get', 'delete'] } },
+                    description: 'Template name (lowercase, snake_case)',
+                },
+                {
+                    displayName: 'Language',
+                    name: 'language',
+                    type: 'string',
+                    default: 'en',
+                    required: true,
+                    displayOptions: { show: { operation: ['get', 'delete'] } },
+                    description: 'Template language code (e.g. en, ar)',
+                },
+                // --- List ---
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    default: false,
+                    displayOptions: { show: { operation: ['list'] } },
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    default: 50,
+                    typeOptions: { minValue: 1, maxValue: 500 },
+                    displayOptions: { show: { operation: ['list'], returnAll: [false] } },
+                },
+                // --- Create ---
+                {
+                    displayName: 'Template Name',
+                    name: 'createName',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { operation: ['create'] } },
+                    description: 'Lowercase, snake_case, must match /^[a-z][a-z0-9_]*$/',
+                },
+                {
+                    displayName: 'Language',
+                    name: 'createLanguage',
+                    type: 'string',
+                    default: 'en',
+                    required: true,
+                    displayOptions: { show: { operation: ['create'] } },
+                },
+                {
+                    displayName: 'Category',
+                    name: 'createCategory',
+                    type: 'options',
+                    default: 'UTILITY',
+                    required: true,
+                    options: [
+                        { name: 'Utility', value: 'UTILITY' },
+                        { name: 'Marketing', value: 'MARKETING' },
+                        { name: 'Authentication', value: 'AUTHENTICATION' },
+                    ],
+                    displayOptions: { show: { operation: ['create'] } },
+                },
+                {
+                    displayName: 'Header Type',
+                    name: 'createHeaderType',
+                    type: 'options',
+                    default: 'NONE',
+                    options: [
+                        { name: 'None', value: 'NONE' },
+                        { name: 'Text', value: 'TEXT' },
+                        { name: 'Image', value: 'IMAGE' },
+                        { name: 'Video', value: 'VIDEO' },
+                        { name: 'Document', value: 'DOCUMENT' },
+                    ],
+                    displayOptions: { show: { operation: ['create'] } },
+                },
+                {
+                    displayName: 'Header Text',
+                    name: 'createHeaderText',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: { operation: ['create'], createHeaderType: ['TEXT'] },
+                    },
+                    description: 'Required when header type = TEXT. Supports {{1}}, {{2}}, … placeholders.',
+                },
+                {
+                    displayName: 'Header Samples',
+                    name: 'createHeaderSamples',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: { operation: ['create'], createHeaderType: ['TEXT'] },
+                    },
+                    description: 'Comma-separated sample values, e.g. "Acme Inc,ConfirmX"',
+                },
+                {
+                    displayName: 'Body Text',
+                    name: 'createBodyText',
+                    type: 'string',
+                    typeOptions: { rows: 4 },
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { operation: ['create'] } },
+                    description: 'Body text with {{1}}, {{2}}, … placeholders',
+                },
+                {
+                    displayName: 'Body Samples',
+                    name: 'createBodySamples',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { operation: ['create'] } },
+                    description: 'Comma-separated sample values',
+                },
+                {
+                    displayName: 'Footer Text',
+                    name: 'createFooterText',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { operation: ['create'] } },
+                },
+                {
+                    displayName: 'Buttons (JSON)',
+                    name: 'createButtons',
+                    type: 'json',
+                    default: '[]',
+                    displayOptions: { show: { operation: ['create'] } },
+                    description: 'JSON array of buttons, each `{type:"QUICK_REPLY"|"URL"|"PHONE_NUMBER", text, url?, phone_number?}`. Example: `[{"type":"URL","text":"Track","url":"https://example.com/track/{{1}}"}]`.',
+                },
+            ],
+            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);
+            return typeof v === 'string' ? v : v?.value;
+        };
+        for (let i = 0; i < items.length; i++) {
+            const operation = this.getNodeParameter('operation', i);
+            const accountId = resolveAccountId(i);
+            if (operation === 'list') {
+                const returnAll = this.getNodeParameter('returnAll', i);
+                const limit = this.getNodeParameter('limit', i) || 50;
+                const res = await (0, http_1.confirmxApiRequest)(this, {
+                    method: 'GET',
+                    endpoint: '/templates',
+                    qs: { accountId },
+                });
+                const sliced = returnAll ? res.templates || [] : (res.templates || []).slice(0, limit);
+                returnData.push(...sliced.map((t) => ({ json: t })));
+            }
+            else if (operation === 'get') {
+                const name = this.getNodeParameter('name', i);
+                const language = this.getNodeParameter('language', i);
+                const res = await (0, http_1.confirmxApiRequest)(this, {
+                    method: 'GET',
+                    endpoint: `/templates/${accountId}/${encodeURIComponent(name)}`,
+                    qs: { language },
+                });
+                returnData.push({ json: res.template });
+            }
+            else if (operation === 'create') {
+                const body = {
+                    accountId,
+                    name: this.getNodeParameter('createName', i),
+                    language: this.getNodeParameter('createLanguage', i),
+                    category: this.getNodeParameter('createCategory', i),
+                    headerType: this.getNodeParameter('createHeaderType', i),
+                };
+                const headerText = this.getNodeParameter('createHeaderText', i, '');
+                const headerSamples = this.getNodeParameter('createHeaderSamples', i, '');
+                const bodyText = this.getNodeParameter('createBodyText', i);
+                const bodySamples = this.getNodeParameter('createBodySamples', i, '');
+                const footerText = this.getNodeParameter('createFooterText', i, '');
+                const buttonsRaw = this.getNodeParameter('createButtons', i, '[]');
+                if (headerText)
+                    body.headerText = headerText;
+                if (headerSamples)
+                    body.headerSamples = headerSamples.split(',').map((s) => s.trim()).filter(Boolean);
+                body.bodyText = bodyText;
+                if (bodySamples)
+                    body.bodySamples = bodySamples.split(',').map((s) => s.trim()).filter(Boolean);
+                if (footerText)
+                    body.footerText = footerText;
+                try {
+                    const parsed = JSON.parse(buttonsRaw || '[]');
+                    if (Array.isArray(parsed) && parsed.length)
+                        body.buttons = parsed;
+                }
+                catch {
+                    throw new Error('Buttons must be valid JSON array');
+                }
+                const res = await (0, http_1.confirmxApiRequest)(this, {
+                    method: 'POST',
+                    endpoint: '/templates',
+                    body,
+                });
+                returnData.push({ json: res });
+            }
+            else if (operation === 'delete') {
+                const name = this.getNodeParameter('name', i);
+                const language = this.getNodeParameter('language', i);
+                const res = await (0, http_1.confirmxApiRequest)(this, {
+                    method: 'DELETE',
+                    endpoint: `/templates/${accountId}/${encodeURIComponent(name)}`,
+                    qs: { language },
+                });
+                returnData.push({ json: { success: true, accountId, name, language, ...res } });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.ConfirmXTemplate = ConfirmXTemplate;
+//# sourceMappingURL=ConfirmXTemplate.node.js.map

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

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

package/nodes/ConfirmX/ConfirmXTemplate.node.ts

@@ -0,0 +1,310 @@
+import type { INodeType, INodeTypeDescription } from 'n8n-workflow'
+import { confirmxApiRequest, loadAccountOptions } from '../../transports/http'
+
+export class ConfirmXTemplate implements INodeType {
+  description: INodeTypeDescription = {
+    displayName: 'ConfirmX Template',
+    name: 'confirmXTemplate',
+    icon: 'file:confirmx.svg',
+    group: ['transform'],
+    version: 1,
+    subtitle: '={{$parameter["operation"]}}',
+    description:
+      'Manage Meta WhatsApp message templates — list, get, create, delete. Templates must be approved by Meta before use.',
+    defaults: { name: 'ConfirmX Template' },
+    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 templates',
+            description:
+              'List all WhatsApp message templates for an account. Returns every status — APPROVED, PENDING, REJECTED — with full `components[]`. Requires `accountId`. Use when you need to discover which templates exist before sending or auditing.',
+          },
+          {
+            name: 'Get',
+            value: 'get',
+            action: 'Get template',
+            description:
+              'Fetch a single template by name and language. Returns the live `components[]` and current Meta approval status. Requires `accountId`, `name`, and `language`. Use after a `template.status` webhook to inspect the latest version.',
+          },
+          {
+            name: 'Create',
+            value: 'create',
+            action: 'Create template',
+            description:
+              'Submit a new template for Meta approval. Returns the new template in PENDING status.',
+          },
+          {
+            name: 'Delete',
+            value: 'delete',
+            action: 'Delete template',
+            description: 'Permanently delete a template.',
+          },
+        ],
+        default: 'list',
+      },
+      {
+        displayName: 'Account',
+        name: 'accountId',
+        type: 'resourceLocator',
+        default: { mode: 'list', value: '' },
+        required: true,
+        displayOptions: {
+          show: { operation: ['list', 'get', 'create', 'delete'] },
+        },
+        modes: [
+          {
+            displayName: 'From List',
+            name: 'list',
+            type: 'list',
+            placeholder: 'Select an account…',
+            typeOptions: { searchable: true },
+          },
+          {
+            displayName: 'By ID',
+            name: 'id',
+            type: 'string',
+            placeholder: 'acc_…',
+          },
+        ],
+        typeOptions: {
+          loadOptionsMethod: 'getAccounts',
+        },
+        description: 'WhatsApp account to act on',
+      },
+      // --- Get / Delete ---
+      {
+        displayName: 'Name',
+        name: 'name',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { operation: ['get', 'delete'] } },
+        description: 'Template name (lowercase, snake_case)',
+      },
+      {
+        displayName: 'Language',
+        name: 'language',
+        type: 'string',
+        default: 'en',
+        required: true,
+        displayOptions: { show: { operation: ['get', 'delete'] } },
+        description: 'Template language code (e.g. en, ar)',
+      },
+      // --- List ---
+      {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        default: false,
+        displayOptions: { show: { operation: ['list'] } },
+      },
+      {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        default: 50,
+        typeOptions: { minValue: 1, maxValue: 500 },
+        displayOptions: { show: { operation: ['list'], returnAll: [false] } },
+      },
+      // --- Create ---
+      {
+        displayName: 'Template Name',
+        name: 'createName',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { operation: ['create'] } },
+        description: 'Lowercase, snake_case, must match /^[a-z][a-z0-9_]*$/',
+      },
+      {
+        displayName: 'Language',
+        name: 'createLanguage',
+        type: 'string',
+        default: 'en',
+        required: true,
+        displayOptions: { show: { operation: ['create'] } },
+      },
+      {
+        displayName: 'Category',
+        name: 'createCategory',
+        type: 'options',
+        default: 'UTILITY',
+        required: true,
+        options: [
+          { name: 'Utility', value: 'UTILITY' },
+          { name: 'Marketing', value: 'MARKETING' },
+          { name: 'Authentication', value: 'AUTHENTICATION' },
+        ],
+        displayOptions: { show: { operation: ['create'] } },
+      },
+      {
+        displayName: 'Header Type',
+        name: 'createHeaderType',
+        type: 'options',
+        default: 'NONE',
+        options: [
+          { name: 'None', value: 'NONE' },
+          { name: 'Text', value: 'TEXT' },
+          { name: 'Image', value: 'IMAGE' },
+          { name: 'Video', value: 'VIDEO' },
+          { name: 'Document', value: 'DOCUMENT' },
+        ],
+        displayOptions: { show: { operation: ['create'] } },
+      },
+      {
+        displayName: 'Header Text',
+        name: 'createHeaderText',
+        type: 'string',
+        default: '',
+        displayOptions: {
+          show: { operation: ['create'], createHeaderType: ['TEXT'] },
+        },
+        description: 'Required when header type = TEXT. Supports {{1}}, {{2}}, … placeholders.',
+      },
+      {
+        displayName: 'Header Samples',
+        name: 'createHeaderSamples',
+        type: 'string',
+        default: '',
+        displayOptions: {
+          show: { operation: ['create'], createHeaderType: ['TEXT'] },
+        },
+        description: 'Comma-separated sample values, e.g. "Acme Inc,ConfirmX"',
+      },
+      {
+        displayName: 'Body Text',
+        name: 'createBodyText',
+        type: 'string',
+        typeOptions: { rows: 4 },
+        default: '',
+        required: true,
+        displayOptions: { show: { operation: ['create'] } },
+        description: 'Body text with {{1}}, {{2}}, … placeholders',
+      },
+      {
+        displayName: 'Body Samples',
+        name: 'createBodySamples',
+        type: 'string',
+        default: '',
+        displayOptions: { show: { operation: ['create'] } },
+        description: 'Comma-separated sample values',
+      },
+      {
+        displayName: 'Footer Text',
+        name: 'createFooterText',
+        type: 'string',
+        default: '',
+        displayOptions: { show: { operation: ['create'] } },
+      },
+      {
+        displayName: 'Buttons (JSON)',
+        name: 'createButtons',
+        type: 'json',
+        default: '[]',
+        displayOptions: { show: { operation: ['create'] } },
+        description:
+          'JSON array of buttons, each `{type:"QUICK_REPLY"|"URL"|"PHONE_NUMBER", text, url?, phone_number?}`. Example: `[{"type":"URL","text":"Track","url":"https://example.com/track/{{1}}"}]`.',
+      },
+    ],
+    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
+      return typeof v === 'string' ? v : v?.value
+    }
+
+    for (let i = 0; i < items.length; i++) {
+      const operation = this.getNodeParameter('operation', i) as string
+      const accountId = resolveAccountId(i)
+
+      if (operation === 'list') {
+        const returnAll = this.getNodeParameter('returnAll', i) as boolean
+        const limit = (this.getNodeParameter('limit', i) as number) || 50
+        const res = await confirmxApiRequest<{ templates: any[] }>(this, {
+          method: 'GET',
+          endpoint: '/templates',
+          qs: { accountId },
+        })
+        const sliced = returnAll ? res.templates || [] : (res.templates || []).slice(0, limit)
+        returnData.push(...sliced.map((t) => ({ json: t })))
+      } else if (operation === 'get') {
+        const name = this.getNodeParameter('name', i) as string
+        const language = this.getNodeParameter('language', i) as string
+        const res = await confirmxApiRequest<{ template: any }>(this, {
+          method: 'GET',
+          endpoint: `/templates/${accountId}/${encodeURIComponent(name)}`,
+          qs: { language },
+        })
+        returnData.push({ json: res.template })
+      } else if (operation === 'create') {
+        const body: Record<string, any> = {
+          accountId,
+          name: this.getNodeParameter('createName', i) as string,
+          language: this.getNodeParameter('createLanguage', i) as string,
+          category: this.getNodeParameter('createCategory', i) as string,
+          headerType: this.getNodeParameter('createHeaderType', i) as string,
+        }
+        const headerText = this.getNodeParameter('createHeaderText', i, '') as string
+        const headerSamples = this.getNodeParameter('createHeaderSamples', i, '') as string
+        const bodyText = this.getNodeParameter('createBodyText', i) as string
+        const bodySamples = this.getNodeParameter('createBodySamples', i, '') as string
+        const footerText = this.getNodeParameter('createFooterText', i, '') as string
+        const buttonsRaw = this.getNodeParameter('createButtons', i, '[]') as string
+
+        if (headerText) body.headerText = headerText
+        if (headerSamples)
+          body.headerSamples = headerSamples.split(',').map((s) => s.trim()).filter(Boolean)
+        body.bodyText = bodyText
+        if (bodySamples)
+          body.bodySamples = bodySamples.split(',').map((s) => s.trim()).filter(Boolean)
+        if (footerText) body.footerText = footerText
+        try {
+          const parsed = JSON.parse(buttonsRaw || '[]')
+          if (Array.isArray(parsed) && parsed.length) body.buttons = parsed
+        } catch {
+          throw new Error('Buttons must be valid JSON array')
+        }
+
+        const res = await confirmxApiRequest<any>(this, {
+          method: 'POST',
+          endpoint: '/templates',
+          body,
+        })
+        returnData.push({ json: res })
+      } else if (operation === 'delete') {
+        const name = this.getNodeParameter('name', i) as string
+        const language = this.getNodeParameter('language', i) as string
+        const res = await confirmxApiRequest<any>(this, {
+          method: 'DELETE',
+          endpoint: `/templates/${accountId}/${encodeURIComponent(name)}`,
+          qs: { language },
+        })
+        returnData.push({ json: { success: true, accountId, name, language, ...res } })
+      }
+    }
+
+    return [returnData]
+  }
+}

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

@@ -0,0 +1,29 @@
+/**
+ * ConfirmX Trigger — starts a flow when ConfirmX emits a webhook event.
+ *
+ * Self-registration lifecycle:
+ *   1. `trigger()` — n8n calls this when the trigger is added/edited or
+ *      the workflow is saved/activated. We POST /api/v1/webhooks with
+ *      the n8n-generated URL + the selected events, then persist the
+ *      returned `secret` in workflow staticData.
+ *   2. `webhook()` — n8n calls this for each incoming POST from ConfirmX.
+ *      We verify the HMAC signature, reject stale timestamps (300s window),
+ *      and emit the envelope's `data` field as the n8n item.
+ *   3. `delete()` / `deactivate()` — best-effort DELETE /api/v1/webhooks/:id.
+ *
+ * Critical invariant: the `secret` MUST persist client-side because
+ * `GET /api/v1/webhooks/:id` does NOT return it. If staticData is wiped
+ * (e.g. n8n SQLite volume loss), the trigger throws a clear error
+ * and the user must re-add the node to re-register.
+ */
+import type { ITriggerFunctions, ITriggerResponse, IWebhookFunctions, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class ConfirmXTrigger implements INodeType {
+    description: INodeTypeDescription;
+    trigger(this: ITriggerFunctions): Promise<ITriggerResponse>;
+    webhook(this: IWebhookFunctions): Promise<{
+        workflowData: {
+            json: any;
+        }[][];
+    }>;
+    delete(this: ITriggerFunctions): Promise<void>;
+}