n8n-nodes-huntsales 0.1.0

package/README.md

@@ -0,0 +1,35 @@
+# n8n-nodes-huntsales
+
+An [n8n](https://n8n.io) community node for [HuntSales](https://huntsales.io) CRM.
+
+- **HuntSales** (action node): query and create contacts, claim prospects, and read credits over the HuntSales MCP API.
+- **HuntSales Trigger**: start a workflow when a HuntSales CRM event happens (reply received, deal won, watchlist match, and more). It registers its own signed webhook endpoint in HuntSales, so there is nothing to wire up by hand.
+
+## Credentials
+
+Create an API key in HuntSales under **Admin, then Developer**. The action node needs read/write scopes for the operations you use. The **Trigger** node also needs the **`webhooks:manage`** scope so it can register and remove its own endpoint.
+
+Enter the key (and your base URL, default `https://huntsales.io`) in the **HuntSales API** credential.
+
+## Install
+
+In n8n: **Settings, then Community Nodes, then Install**, and enter `n8n-nodes-huntsales`.
+
+## Build and publish (maintainers)
+
+```bash
+cd packages/n8n-nodes-huntsales
+npm install
+npm run build      # tsc -> dist/
+npm publish --access public
+```
+
+`npm publish` is a manual step performed by a maintainer with npm access. This repository ships the source only; it is not published automatically.
+
+## Webhook signatures
+
+Every delivered event carries `X-HuntSales-Signature: sha256=<hmac(secret, body)>`. The signing secret is returned once when the endpoint is created (the Trigger stores it in workflow static data). Verify it in a downstream step if you want to authenticate deliveries.
+
+## License
+
+MIT

package/dist/credentials/HuntSalesApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import type { ICredentialType, INodeProperties } from "n8n-workflow";
+export declare class HuntSalesApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/HuntSalesApi.credentials.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HuntSalesApi = void 0;
+// HuntSales API key credential. Create a key in HuntSales under
+// Admin, then Developer. For the trigger node, the key needs the
+// "webhooks:manage" scope so n8n can register its own webhook endpoint.
+class HuntSalesApi {
+    constructor() {
+        this.name = "huntSalesApi";
+        this.displayName = "HuntSales API";
+        this.documentationUrl = "https://huntsales.io/docs/n8n";
+        this.properties = [
+            {
+                displayName: "API Key",
+                name: "apiKey",
+                type: "string",
+                typeOptions: { password: true },
+                default: "",
+                required: true,
+                description: "An hs_live_... key from HuntSales, Admin, Developer.",
+            },
+            {
+                displayName: "Base URL",
+                name: "baseUrl",
+                type: "string",
+                default: "https://huntsales.io",
+                description: "Your HuntSales base URL (change only for a self-hosted region).",
+            },
+        ];
+    }
+}
+exports.HuntSalesApi = HuntSalesApi;

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

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from "n8n-workflow";
+export declare class HuntSales implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/HuntSales/HuntSales.node.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HuntSales = void 0;
+// Call a HuntSales MCP tool over JSON-RPC 2.0.
+async function callTool(ctx, toolName, args) {
+    const creds = await ctx.getCredentials("huntSalesApi");
+    const baseUrl = String(creds.baseUrl || "https://huntsales.io").replace(/\/$/, "");
+    const body = {
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: { name: toolName, arguments: args },
+    };
+    const res = (await ctx.helpers.httpRequest({
+        method: "POST",
+        url: `${baseUrl}/api/mcp`,
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${creds.apiKey}`,
+        },
+        body,
+        json: true,
+    }));
+    if (res.error) {
+        throw new Error(res.error.message || "HuntSales MCP error");
+    }
+    return res.result;
+}
+class HuntSales {
+    constructor() {
+        this.description = {
+            displayName: "HuntSales",
+            name: "huntSales",
+            icon: "file:huntsales.svg",
+            group: ["transform"],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: "Query and create contacts, claim prospects, and read credits",
+            defaults: { name: "HuntSales" },
+            inputs: ["main"],
+            outputs: ["main"],
+            credentials: [{ name: "huntSalesApi", required: true }],
+            properties: [
+                {
+                    displayName: "Operation",
+                    name: "operation",
+                    type: "options",
+                    noDataExpression: true,
+                    options: [
+                        { name: "Query Contacts", value: "queryContacts" },
+                        { name: "Create Contact", value: "createContact" },
+                        { name: "Claim Prospects", value: "claimProspects" },
+                        { name: "Get Credits", value: "getCredits" },
+                    ],
+                    default: "queryContacts",
+                },
+                {
+                    displayName: "Search",
+                    name: "search",
+                    type: "string",
+                    default: "",
+                    displayOptions: { show: { operation: ["queryContacts"] } },
+                    description: "Name, email or company to search for",
+                },
+                {
+                    displayName: "Contact Name",
+                    name: "contactName",
+                    type: "string",
+                    default: "",
+                    displayOptions: { show: { operation: ["createContact"] } },
+                },
+                {
+                    displayName: "Email",
+                    name: "email",
+                    type: "string",
+                    default: "",
+                    displayOptions: { show: { operation: ["createContact"] } },
+                },
+                {
+                    displayName: "Confirm (actually run)",
+                    name: "confirm",
+                    type: "boolean",
+                    default: false,
+                    displayOptions: { show: { operation: ["claimProspects"] } },
+                    description: "Off returns a dry-run preview; on actually claims and spends quota",
+                },
+                {
+                    displayName: "Job Titles (comma separated)",
+                    name: "jobTitles",
+                    type: "string",
+                    default: "",
+                    displayOptions: { show: { operation: ["claimProspects"] } },
+                },
+                {
+                    displayName: "Limit",
+                    name: "limit",
+                    type: "number",
+                    default: 25,
+                    displayOptions: { show: { operation: ["claimProspects"] } },
+                },
+            ],
+        };
+    }
+    async execute() {
+        var _a;
+        const items = this.getInputData();
+        const out = [];
+        for (let i = 0; i < items.length; i++) {
+            const operation = this.getNodeParameter("operation", i);
+            let result;
+            if (operation === "queryContacts") {
+                result = await callTool(this, "query_contacts", {
+                    search: this.getNodeParameter("search", i),
+                });
+            }
+            else if (operation === "createContact") {
+                result = await callTool(this, "create_contact", {
+                    contact_name: this.getNodeParameter("contactName", i),
+                    email: this.getNodeParameter("email", i),
+                });
+            }
+            else if (operation === "claimProspects") {
+                const titles = this.getNodeParameter("jobTitles", i)
+                    .split(",")
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+                result = await callTool(this, "claim_prospects", {
+                    job_titles: titles,
+                    limit: this.getNodeParameter("limit", i),
+                    confirm: this.getNodeParameter("confirm", i),
+                });
+            }
+            else if (operation === "getCredits") {
+                result = await callTool(this, "get_credits", {});
+            }
+            out.push({ json: (_a = result) !== null && _a !== void 0 ? _a : {} });
+        }
+        return [out];
+    }
+}
+exports.HuntSales = HuntSales;

package/dist/nodes/HuntSales/HuntSalesTrigger.node.d.ts

@@ -0,0 +1,12 @@
+import type { IHookFunctions, IWebhookFunctions, INodeType, INodeTypeDescription, IWebhookResponseData } from "n8n-workflow";
+export declare class HuntSalesTrigger implements INodeType {
+    description: INodeTypeDescription;
+    webhookMethods: {
+        default: {
+            checkExists(this: IHookFunctions): Promise<boolean>;
+            create(this: IHookFunctions): Promise<boolean>;
+            delete(this: IHookFunctions): Promise<boolean>;
+        };
+    };
+    webhook(this: IWebhookFunctions): Promise<IWebhookResponseData>;
+}

package/dist/nodes/HuntSales/HuntSalesTrigger.node.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HuntSalesTrigger = void 0;
+// HuntSales Trigger: registers an outbound webhook endpoint in HuntSales (via an
+// API key with the webhooks:manage scope) and fires the workflow when the chosen
+// events arrive. Signature verification of X-HuntSales-Signature can be added by
+// the user with the endpoint's signing secret.
+class HuntSalesTrigger {
+    constructor() {
+        this.description = {
+            displayName: "HuntSales Trigger",
+            name: "huntSalesTrigger",
+            icon: "file:huntsales.svg",
+            group: ["trigger"],
+            version: 1,
+            description: "Starts the workflow on a HuntSales CRM event",
+            defaults: { name: "HuntSales Trigger" },
+            inputs: [],
+            outputs: ["main"],
+            credentials: [{ name: "huntSalesApi", required: true }],
+            webhooks: [
+                {
+                    name: "default",
+                    httpMethod: "POST",
+                    responseMode: "onReceived",
+                    path: "webhook",
+                },
+            ],
+            properties: [
+                {
+                    displayName: "Events",
+                    name: "events",
+                    type: "multiOptions",
+                    required: true,
+                    default: ["reply.received"],
+                    options: [
+                        { name: "Reply received", value: "reply.received" },
+                        { name: "Contact created", value: "contact.created" },
+                        { name: "Stage changed", value: "contact.stage_changed" },
+                        { name: "Contact assigned", value: "contact.assigned" },
+                        { name: "Campaign launched", value: "campaign.launched" },
+                        { name: "Campaign completed", value: "campaign.completed" },
+                        { name: "Email opened", value: "email.opened" },
+                        { name: "Email clicked", value: "email.clicked" },
+                        { name: "Email bounced", value: "email.bounced" },
+                        { name: "Contact unsubscribed", value: "contact.unsubscribed" },
+                        { name: "Call completed", value: "call.completed" },
+                        { name: "Meeting scored", value: "meeting.scored" },
+                        { name: "Deal created", value: "deal.created" },
+                        { name: "Deal won", value: "deal.won" },
+                        { name: "Watchlist match", value: "watchlist.match" },
+                        { name: "Credits low", value: "credits.low" },
+                    ],
+                },
+            ],
+        };
+        this.webhookMethods = {
+            default: {
+                async checkExists() {
+                    const data = this.getWorkflowStaticData("node");
+                    return Boolean(data.endpointId);
+                },
+                async create() {
+                    var _a;
+                    const creds = await this.getCredentials("huntSalesApi");
+                    const baseUrl = String(creds.baseUrl || "https://huntsales.io").replace(/\/$/, "");
+                    const webhookUrl = this.getNodeWebhookUrl("default");
+                    const events = this.getNodeParameter("events");
+                    const res = (await this.helpers.httpRequest({
+                        method: "POST",
+                        url: `${baseUrl}/api/webhook-endpoints`,
+                        headers: {
+                            "Content-Type": "application/json",
+                            Authorization: `Bearer ${creds.apiKey}`,
+                        },
+                        body: { url: webhookUrl, events },
+                        json: true,
+                    }));
+                    const data = this.getWorkflowStaticData("node");
+                    data.endpointId = (_a = res.endpoint) === null || _a === void 0 ? void 0 : _a.id;
+                    data.secret = res.secret;
+                    return true;
+                },
+                async delete() {
+                    const data = this.getWorkflowStaticData("node");
+                    if (!data.endpointId)
+                        return true;
+                    const creds = await this.getCredentials("huntSalesApi");
+                    const baseUrl = String(creds.baseUrl || "https://huntsales.io").replace(/\/$/, "");
+                    await this.helpers.httpRequest({
+                        method: "DELETE",
+                        url: `${baseUrl}/api/webhook-endpoints?id=${data.endpointId}`,
+                        headers: { Authorization: `Bearer ${creds.apiKey}` },
+                    });
+                    delete data.endpointId;
+                    delete data.secret;
+                    return true;
+                },
+            },
+        };
+    }
+    async webhook() {
+        const body = this.getBodyData();
+        return { workflowData: [this.helpers.returnJsonArray([body])] };
+    }
+}
+exports.HuntSalesTrigger = HuntSalesTrigger;

package/dist/nodes/HuntSales/huntsales.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect width="64" height="64" rx="14" fill="#1f5fe0"/>
+  <path d="M20 16h6v13h12V16h6v32h-6V35H26v13h-6z" fill="#fff"/>
+</svg>

package/index.js

@@ -0,0 +1,3 @@
+// n8n loads nodes and credentials from the compiled files listed in the "n8n"
+// field of package.json (dist/**). This entry point is intentionally empty.
+module.exports = {};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "n8n-nodes-huntsales",
+  "version": "0.1.0",
+  "description": "n8n community node for the HuntSales CRM: query and create contacts, claim prospects, run campaigns, and trigger on CRM events.",
+  "keywords": [
+    "n8n-community-node-package",
+    "huntsales",
+    "crm"
+  ],
+  "license": "MIT",
+  "homepage": "https://huntsales.io",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/HuntSalesApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/HuntSales/HuntSales.node.js",
+      "dist/nodes/HuntSales/HuntSalesTrigger.node.js"
+    ]
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "devDependencies": {
+    "n8n-workflow": "^1.60.0",
+    "typescript": "^5.5.0"
+  }
+}