n8n-nodes-linq 0.1.2 → 0.1.4

package/README.md

@@ -19,17 +19,17 @@ Linq Partner API (v2) community node for n8n. This node lets you manage chats, m
 
 ## Credentials
 
-Create a new credential of type “Linq API” and set your Integration Token:
+Create a new credential of type "Linq API" and set your Integration Token:
 
 - Header used: `X-LINQ-INTEGRATION-TOKEN: <your token>`
 - The field is hidden in the UI (password type).
 
-Where it’s defined:
+Where it's defined:
 - [class LinqApi implements ICredentialType](credentials/LinqApi.credentials.ts:1)
 
 ## Node usage
 
-Add the “Linq” node to your workflow. The node provides Resources and Operations that map 1:1 to the documented Linq Partner API endpoints.
+Add the "Linq" node to your workflow. The node provides Resources and Operations that map 1:1 to the documented Linq Partner API endpoints.
 
 - Node implementation:
   - [class Linq implements INodeType](nodes/Linq/Linq.node.ts:1)
@@ -61,32 +61,49 @@ The node implements all endpoints from your Linq Partner API documentation (v2):
 - Resource: Phone Number
   - Operations:
     - Get Many → GET `/phone_numbers`
-    - Check iMessage Availability → POST `/i_message_availability/check` (`phone_number`)
+    - Check iMessage Availability → GET `/phone_numbers/:phoneNumber/check_imessage`
 
 - Resource: Webhook Subscription
   - Operations:
     - Get Many → GET `/webhook_subscriptions`
     - Get One → GET `/webhook_subscriptions/:id`
-    - Create → POST `/webhook_subscriptions` (`webhook_url`, `events[]`, `version`, `active`)
-    - Update → PUT `/webhook_subscriptions/:id` (update any subset of: `webhook_url`, `events[]`, `version`, `active`)
+    - Create → POST `/webhook_subscriptions`
+    - Update → PUT `/webhook_subscriptions/:id`
     - Delete → DELETE `/webhook_subscriptions/:id`
 
 - Resource: Contact
   - Operations:
-    - Create → POST `/contacts` (`contact{ first_name, last_name, email, phone_number, company, title, location }`)
+    - Create → POST `/contacts`
     - Get One → GET `/contacts/:id`
-    - Update → PUT `/contacts/:id` (any subset of contact fields)
+    - Update → PUT `/contacts/:id`
     - Delete → DELETE `/contacts/:id`
 
-### Common parameters
+### Linq Trigger Node
 
-- Pagination (chats): `page`, `perPage`
-- Filtering (chats, find): `phoneNumber`
-- IDs: `chatId`, `chatMessageId`, `contactId`, `webhookSubscriptionId`
+Add the "Linq Trigger" node to automatically start workflows when Linq events occur. The node automatically registers a webhook with Linq when the workflow is activated.
 
-## Examples
+- Supported Events:
+  - Message Sent (`message.sent`)
+  - Message Received (`message.received`)
+  - Message Read (`message.read`)
+  - Call Completed (`call.completed`)
+  - Contact Created (`contact.created`)
+  - Contact Updated (`contact.updated`)
+  - Contact Deleted (`contact.deleted`)
 
-1) Create a chat and send an initial message
+- Configuration:
+  1. Add the "Linq Trigger" node to your workflow
+  2. Select which events should trigger the workflow
+  3. Activate the workflow (this registers the webhook with Linq)
+  4. Linq will send events to your workflow when they occur
+
+- Security:
+  - The node verifies the signature of incoming events using HMAC-SHA256
+  - Requires the same Linq API credentials as the main node
+
+### Example workflows
+
+1) Send a group message
 - Resource: Chat
 - Operation: Create
 - Fields:
@@ -140,7 +157,7 @@ Local link for testing in a local n8n:
 npm link
 # in your n8n folder
 npm link n8n-nodes-linq
-# restart n8n, then add “Linq” node
+# restart n8n, then add "Linq" node
 ```
 
 Project files of interest:
@@ -174,9 +191,3 @@ npm publish --access public
 - Node description references it as `icon: 'file:linq.svg'`, so it renders in the n8n UI.
 
 ## License
-
-MIT — see [LICENSE.md](LICENSE.md:1)
-
-## Support
-
-Issues and suggestions are welcome. Please open an issue in your repository once you push the source (see `repository` field in [package.json](package.json:1)).

package/dist/nodes/LinqTrigger/LinqTrigger.node.d.ts

@@ -0,0 +1,5 @@
+import { INodeType, INodeTypeDescription, IWebhookResponseData } from 'n8n-workflow';
+export declare class LinqTrigger implements INodeType {
+    description: INodeTypeDescription;
+    webhook(this: any): Promise<IWebhookResponseData>;
+}

package/dist/nodes/LinqTrigger/LinqTrigger.node.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinqTrigger = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+class LinqTrigger {
+    constructor() {
+        this.description = {
+            displayName: 'Linq Trigger',
+            name: 'linqTrigger',
+            icon: 'file:linq.svg',
+            group: ['trigger'],
+            version: 1,
+            description: 'Handle Linq webhook events',
+            defaults: {
+                name: 'Linq Trigger',
+            },
+            inputs: [],
+            outputs: ["main" /* NodeConnectionType.Main */],
+            credentials: [
+                {
+                    name: 'linqApi',
+                    required: true,
+                },
+            ],
+            webhooks: [
+                {
+                    name: 'default',
+                    httpMethod: 'POST',
+                    responseCode: '200',
+                    path: 'webhook',
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Events',
+                    name: 'events',
+                    type: 'multiOptions',
+                    options: [
+                        {
+                            name: 'Call Completed',
+                            value: 'call.completed',
+                        },
+                        {
+                            name: 'Contact Created',
+                            value: 'contact.created',
+                        },
+                        {
+                            name: 'Contact Deleted',
+                            value: 'contact.deleted',
+                        },
+                        {
+                            name: 'Contact Updated',
+                            value: 'contact.updated',
+                        },
+                        {
+                            name: 'Message Read',
+                            value: 'message.read',
+                        },
+                        {
+                            name: 'Message Received',
+                            value: 'message.received',
+                        },
+                        {
+                            name: 'Message Sent',
+                            value: 'message.sent',
+                        },
+                    ],
+                    default: [],
+                    description: 'Select the events to listen for',
+                },
+            ],
+        };
+    }
+    async webhook() {
+        const bodyData = this.getBodyData();
+        const headers = this.getHeaderData();
+        const event = headers['x-linq-event'];
+        const signature = headers['x-linq-signature'];
+        // Verify signature (optional but recommended)
+        const credentials = await this.getCredentials('linqApi');
+        const crypto = require('crypto');
+        const expectedSignature = crypto
+            .createHmac('sha256', credentials.integrationToken)
+            .update(JSON.stringify(bodyData))
+            .digest('hex');
+        if (signature !== expectedSignature) {
+            throw new n8n_workflow_1.ApplicationError('Invalid signature');
+        }
+        // Return the event data to start the workflow
+        const returnData = [
+            {
+                json: {
+                    event,
+                    payload: bodyData,
+                },
+            },
+        ];
+        return {
+            workflowData: [returnData],
+        };
+    }
+}
+exports.LinqTrigger = LinqTrigger;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-linq",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Linq API integration for n8n",
   "keywords": [
     "n8n-community-node-package",
@@ -36,7 +36,8 @@
       "dist/credentials/LinqApi.credentials.js"
     ],
     "nodes": [
-      "dist/nodes/Linq/Linq.node.js"
+      "dist/nodes/Linq/Linq.node.js",
+      "dist/nodes/LinqTrigger/LinqTrigger.node.js"
     ]
   },
   "devDependencies": {