@linkorb/n8n-nodes-nebula 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Joost Faassen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,438 @@
+# n8n-nodes-nebula
+
+A custom n8n node for implementing **Nebula HITL (Human-in-the-Loop)** workflows with your own configurable REST API backend.
+
+![Nebula HITL Request Node](docs/node-screenshot.png)
+
+## Description
+
+This node allows you to create human approval/input requests in your n8n workflows. Unlike other HITL solutions that are tied to specific cloud services, this node is designed to work with **your own backend**, giving you full control over how requests are created, stored, displayed, and responded to.
+
+### Features
+
+- ⏸️ **True Wait Functionality**: Workflow execution pauses until a human responds
+- 🔐 **Configurable Backend**: Connect to your own REST API endpoint
+- 📝 **Multiple Response Types**: Ok, Yes/No, Text, or Custom options
+- 🏷️ **Rich Metadata**: Support for priority, assignee, tags, and custom data
+- 🔄 **Webhook-based Responses**: Automatically resume workflow when human responds
+- ⏰ **Configurable Timeout**: Set how long to wait for a response
+- 📊 **Full Context**: Pass workflow and execution context to your backend
+
+### How It Works
+
+1. **Request Creation**: The node POSTs a request to your backend with all details including a webhook URL
+2. **Workflow Pauses**: The n8n execution enters a "waiting" state - no resources are consumed while waiting
+3. **Human Action**: Your backend displays the request to a human for action
+4. **Webhook Callback**: When the human responds, your backend POSTs to the webhook URL
+5. **Workflow Resumes**: n8n receives the webhook, resumes the workflow with the response data as output
+
+## Installation
+
+### Prerequisites
+
+- n8n version 1.0.0 or later
+- Node.js 18.10 or later
+- pnpm (recommended) or npm
+
+### Install via npm (Community Nodes)
+
+In your n8n instance, go to **Settings → Community Nodes** and install:
+
+```
+n8n-nodes-nebula
+```
+
+### Manual Installation (Self-hosted n8n)
+
+1. **Clone or download this repository:**
+
+```bash
+cd ~/.n8n/custom
+git clone https://github.com/linkorb/n8n-nodes-nebula.git
+cd n8n-nodes-nebula
+```
+
+2. **Install dependencies:**
+
+```bash
+pnpm install
+```
+
+3. **Build the node:**
+
+```bash
+pnpm build
+```
+
+4. **Restart n8n:**
+
+```bash
+# If running n8n directly
+n8n start
+
+# If running via PM2
+pm2 restart n8n
+
+# If running via Docker
+docker restart n8n
+```
+
+### Installation with Docker
+
+If you're running n8n in Docker, you can mount the custom nodes:
+
+```yaml
+version: '3.8'
+services:
+  n8n:
+    image: n8nio/n8n
+    volumes:
+      - ~/.n8n:/home/node/.n8n
+      - ./n8n-nodes-nebula:/home/node/.n8n/custom/n8n-nodes-nebula
+    environment:
+      - N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom
+```
+
+## Configuration
+
+### Setting up Credentials
+
+1. In n8n, go to **Credentials → Add Credential**
+2. Search for "Nebula API"
+3. Fill in the required fields:
+
+| Field | Description | Example |
+|-------|-------------|---------|
+| **Base URL** | Your Nebula API backend base URL | `https://api.mycompany.com/nebula` |
+| **Username** | Authentication username | `n8n-service` |
+| **Password** | Authentication password | `your-secure-password` |
+| **Metadata** | Additional JSON data for all requests | `{"tenantId": "abc123"}` |
+
+> **Note:** The webhook callback URL is automatically determined from your n8n instance configuration. You don't need to specify it manually.
+
+## Usage
+
+### Basic Workflow
+
+1. Add the **Nebula HITL Request** node to your workflow
+2. Connect it to your workflow flow
+3. Configure the node:
+   - **Title**: A short description of what needs human attention
+   - **Message**: Detailed markdown-formatted message
+   - **Response Type**: Choose from Ok, Yes/No, Text, or Form
+
+### Response Types
+
+| Type | Description | Response Value |
+|------|-------------|----------------|
+| **Ok** | Simple acknowledgement | `"ok"` |
+| **Yes/No** | Binary choice | `"yes"` or `"no"` |
+| **Text** | Free-form text input | User's text input |
+| **Form (survey.json)** | Custom form in survey.json format | Form submission data |
+
+### Form JSON Example
+
+The Form response type uses [survey.json](https://surveyjs.io/form-library/documentation/design-survey/create-a-simple-survey) format:
+
+```json
+{
+  "elements": [
+    {
+      "type": "radiogroup",
+      "name": "decision",
+      "title": "Please select an option",
+      "choices": ["Approve", "Reject", "Need More Info"]
+    },
+    {
+      "type": "text",
+      "name": "comment",
+      "title": "Additional comments"
+    }
+  ]
+}
+```
+
+### Node Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| **Priority** | Request priority level | `normal` |
+| **Timeout (Minutes)** | Auto-timeout for requests | `0` (no timeout) |
+| **Assignee** | Email/ID to assign request to | (none) |
+| **Tags** | Comma-separated tags | (none) |
+
+### Additional Data
+
+You can pass additional JSON data that will be included in the request to your backend:
+
+```json
+{
+  "orderId": "12345",
+  "customerName": "John Doe",
+  "amount": 150.00
+}
+```
+
+## Backend API Requirements
+
+Your backend API needs to implement the following endpoint:
+
+### POST /requests
+
+Creates a new HITL request.
+
+**Request Body:**
+
+```json
+{
+  "requestId": "uuid-v4-string",
+  "title": "Approval Required",
+  "message": "Please review this order...",
+  "responseType": "yesno",
+  "form": null,
+  "webhookUrl": "https://your-n8n.com/webhook-waiting/xxx/nebula-hitl-response",
+  "priority": "normal",
+  "timeoutMinutes": 0,
+  "assignee": "john@example.com",
+  "tags": ["urgent", "finance"],
+  "metadata": {"tenantId": "abc123"},
+  "additionalData": {"orderId": "12345"},
+  "inputData": {},
+  "workflowId": "workflow-id",
+  "executionId": "execution-id",
+  "createdAt": "2024-01-15T10:30:00Z"
+}
+```
+
+**Response:**
+
+```json
+{
+  "success": true,
+  "requestId": "uuid-v4-string",
+  "status": "pending"
+}
+```
+
+### Webhook Callback (IMPORTANT - This Resumes the Workflow!)
+
+When a human responds, your backend **MUST** call the `webhookUrl` provided in the request payload. This is what resumes the waiting n8n workflow execution.
+
+**POST to webhookUrl:**
+
+```json
+{
+  "requestId": "uuid-v4-string",
+  "response": "approved",
+  "responseValue": "approved",
+  "respondedBy": "john@example.com",
+  "respondedAt": "2024-01-15T11:45:00Z",
+  "comment": "Looks good!",
+  "data": {
+    "anyAdditionalData": "you want to pass"
+  }
+}
+```
+
+**What happens:**
+1. n8n receives the webhook POST
+2. The waiting workflow execution resumes
+3. The Nebula HITL Request node outputs the webhook payload data
+4. Subsequent nodes in your workflow can access `$json.response`, `$json.respondedBy`, etc.
+
+**The webhook URL format:** `https://your-n8n-instance.com/webhook-waiting/{executionId}/nebula-hitl-response`
+
+The `webhookUrl` is automatically constructed and included in the request payload sent to your backend. Your backend simply needs to POST to this URL when a human responds.
+
+### Health Check (Optional)
+
+For credential testing, implement:
+
+**GET /health**
+
+```json
+{
+  "status": "ok"
+}
+```
+
+## Example Backend Implementation
+
+Here's a minimal Express.js backend example:
+
+```javascript
+const express = require('express');
+const app = express();
+
+app.use(express.json());
+
+// Store requests in memory (use a database in production)
+const requests = new Map();
+
+// Create request
+app.post('/requests', (req, res) => {
+  const { requestId, webhookUrl, ...data } = req.body;
+  
+  requests.set(requestId, {
+    ...data,
+    requestId,
+    webhookUrl,
+    status: 'pending'
+  });
+  
+  console.log('New Nebula HITL request:', requestId, data.title);
+  
+  res.json({ success: true, requestId, status: 'pending' });
+});
+
+// Respond to request (called by your UI)
+app.post('/requests/:requestId/respond', async (req, res) => {
+  const requestId = req.params.requestId;
+  const { response, respondedBy } = req.body;
+  
+  const request = requests.get(requestId);
+  if (!request) {
+    return res.status(404).json({ error: 'Request not found' });
+  }
+  
+  // Call n8n webhook to resume workflow
+  await fetch(request.webhookUrl, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      requestId,
+      response,
+      responseValue: response,
+      respondedBy,
+      respondedAt: new Date().toISOString()
+    })
+  });
+  
+  requests.delete(requestId);
+  
+  res.json({ success: true });
+});
+
+// Health check
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok' });
+});
+
+app.listen(3000, () => {
+  console.log('Nebula HITL Backend running on port 3000');
+});
+```
+
+## Workflow Example
+
+```
+[Trigger] → [Process Data] → [Nebula HITL Request] → [If Response == "approved"] → [Continue]
+                                                              ↓
+                                                   [Handle Rejection]
+```
+
+### Accessing Response Data
+
+After the Nebula HITL Request node resumes (when the webhook is called), the node outputs the webhook payload data. You can access:
+
+```javascript
+// In a Code node or expression
+const requestId = $json.requestId;       // The original request ID
+const response = $json.response;         // The response value (e.g., "approved", "yes", "rejected")
+const responseValue = $json.responseValue; // Same as response (for compatibility)
+const respondedBy = $json.respondedBy;   // Who responded (email/ID)
+const respondedAt = $json.respondedAt;   // ISO timestamp when they responded
+const comment = $json.comment;           // Optional comment from responder
+const data = $json.data;                 // Any additional data from your backend
+```
+
+**Example: Using in an IF node condition:**
+```
+{{ $json.response }} equals "approved"
+```
+
+**Example: Send notification with response:**
+```
+The request was {{ $json.response }} by {{ $json.respondedBy }} at {{ $json.respondedAt }}
+```
+
+## Development
+
+### Project Structure
+
+```
+n8n-nodes-nebula/
+├── credentials/
+│   └── NebulaApi.credentials.ts
+├── nodes/
+│   └── NebulaHitlRequest/
+│       ├── NebulaHitlRequest.node.ts
+│       ├── NebulaHitlRequest.node.json
+│       └── nebulaHitlRequest.svg
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+### Building from Source
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Watch mode (for development)
+pnpm dev
+
+# Lint
+pnpm lint
+
+# Format
+pnpm format
+```
+
+## Troubleshooting
+
+### Node not appearing in n8n
+
+1. Ensure the build completed successfully (`pnpm build`)
+2. Check that the `dist` folder contains compiled JS files
+3. Verify the custom nodes path in n8n configuration
+4. Restart n8n completely
+
+### Webhook not being called
+
+1. Ensure your n8n instance is publicly accessible or your backend can reach it
+2. Check the webhookUrl in your backend logs
+3. Verify the requestId matches in both the request and response
+
+### Authentication errors
+
+1. Verify credentials in n8n are correct
+2. Check your backend's authentication logic
+3. Look at the backend logs for more details
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Related Projects
+
+- [n8n](https://n8n.io) - Fair-code workflow automation
+- [n8n documentation on creating nodes](https://docs.n8n.io/integrations/creating-nodes/)
+
+## Support
+
+- Create an issue on GitHub for bug reports
+- Discussions for questions and feature requests

package/dist/credentials/NebulaApi.credentials.d.ts

@@ -0,0 +1,11 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class NebulaApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    icon: "fa:circle-nodes";
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}
+//# sourceMappingURL=NebulaApi.credentials.d.ts.map

package/dist/credentials/NebulaApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NebulaApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/NebulaApi.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,eAAe,EAChB,MAAM,cAAc,CAAC;AAEtB,qBAAa,SAAU,YAAW,eAAe;IAC/C,IAAI,SAAe;IACnB,WAAW,SAAgB;IAC3B,gBAAgB,SAAiD;IAIjE,IAAI,EAAG,iBAAiB,CAAU;IAElC,UAAU,EAAE,eAAe,EAAE,CAqC3B;IAEF,YAAY,EAAE,oBAAoB,CAQhC;IAEF,IAAI,EAAE,sBAAsB,CAM1B;CACH"}

package/dist/credentials/NebulaApi.credentials.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NebulaApi = void 0;
+class NebulaApi {
+    name = 'nebulaApi';
+    displayName = 'Nebula API';
+    documentationUrl = 'https://github.com/linkorb/n8n-nodes-nebula';
+    // Note: Custom SVG icons don't work with N8N_CUSTOM_EXTENSIONS due to n8n bug
+    // See: https://github.com/n8n-io/n8n/issues/21360
+    // Using Font Awesome as fallback. Install via npm for custom SVG icons.
+    icon = 'fa:circle-nodes';
+    properties = [
+        {
+            displayName: 'Base URL',
+            name: 'baseUrl',
+            type: 'string',
+            default: '',
+            placeholder: 'https://api.example.com',
+            description: 'The base URL of your Nebula API backend',
+            required: true,
+        },
+        {
+            displayName: 'Username',
+            name: 'username',
+            type: 'string',
+            default: '',
+            description: 'Username for authentication with the API',
+            required: true,
+        },
+        {
+            displayName: 'Password',
+            name: 'password',
+            type: 'string',
+            typeOptions: {
+                password: true,
+            },
+            default: '',
+            description: 'Password for authentication with the API',
+            required: true,
+        },
+        {
+            displayName: 'Metadata',
+            name: 'metadata',
+            type: 'json',
+            default: '{}',
+            description: 'Additional JSON metadata to include with all requests (e.g., tenant ID, environment)',
+            placeholder: '{"tenantId": "abc123", "environment": "production"}',
+        },
+    ];
+    authenticate = {
+        type: 'generic',
+        properties: {
+            auth: {
+                username: '={{$credentials.username}}',
+                password: '={{$credentials.password}}',
+            },
+        },
+    };
+    test = {
+        request: {
+            baseURL: '={{$credentials.baseUrl}}',
+            url: '/health',
+            method: 'GET',
+        },
+    };
+}
+exports.NebulaApi = NebulaApi;
+//# sourceMappingURL=NebulaApi.credentials.js.map

package/dist/credentials/NebulaApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NebulaApi.credentials.js","sourceRoot":"","sources":["../../credentials/NebulaApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,SAAS;IACpB,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,YAAY,CAAC;IAC3B,gBAAgB,GAAG,6CAA6C,CAAC;IACjE,8EAA8E;IAC9E,kDAAkD;IAClD,wEAAwE;IACxE,IAAI,GAAG,iBAA0B,CAAC;IAElC,UAAU,GAAsB;QAC9B;YACE,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,yBAAyB;YACtC,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,IAAI;SACf;QACD;YACE,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,0CAA0C;YACvD,QAAQ,EAAE,IAAI;SACf;QACD;YACE,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE;gBACX,QAAQ,EAAE,IAAI;aACf;YACD,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,0CAA0C;YACvD,QAAQ,EAAE,IAAI;SACf;QACD;YACE,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,sFAAsF;YACnG,WAAW,EAAE,qDAAqD;SACnE;KACF,CAAC;IAEF,YAAY,GAAyB;QACnC,IAAI,EAAE,SAAS;QACf,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,QAAQ,EAAE,4BAA4B;gBACtC,QAAQ,EAAE,4BAA4B;aACvC;SACF;KACF,CAAC;IAEF,IAAI,GAA2B;QAC7B,OAAO,EAAE;YACP,OAAO,EAAE,2BAA2B;YACpC,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,KAAK;SACd;KACF,CAAC;CACH;AAjED,8BAiEC"}

package/dist/credentials/nebulaApi.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60">
+  <rect width="60" height="60" rx="8" fill="#1a1a2e"/>
+  <g transform="translate(10, 10)">
+    <path d="M20 2C10.059 2 2 10.059 2 20s8.059 18 18 18c4.641 0 8.886-1.76 12.082-4.646l4.95 4.95v-3.608h4.085L35.355 29.1A17.91 17.91 0 0038 20c0-9.941-8.059-18-18-18z" fill="#F58220"/>
+    <circle cx="20" cy="20" r="9" fill="#1a1a2e"/>
+    <path d="M30 28l10 10v-6h-4v-6h-6z" fill="#F58220"/>
+  </g>
+  <circle cx="10" cy="10" r="1.2" fill="#fff" opacity="0.5"/>
+  <circle cx="50" cy="8" r="0.8" fill="#fff" opacity="0.4"/>
+  <circle cx="52" cy="50" r="1" fill="#fff" opacity="0.5"/>
+</svg>

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,7 @@
+import { IExecuteFunctions, INodeType, INodeTypeDescription, INodeExecutionData, IWebhookFunctions, IWebhookResponseData } from 'n8n-workflow';
+export declare class NebulaHitlRequest implements INodeType {
+    description: INodeTypeDescription;
+    webhook(this: IWebhookFunctions): Promise<IWebhookResponseData>;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=NebulaHitlRequest.node.d.ts.map

package/dist/nodes/NebulaHitlRequest/NebulaHitlRequest.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NebulaHitlRequest.node.d.ts","sourceRoot":"","sources":["../../../nodes/NebulaHitlRequest/NebulaHitlRequest.node.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EAGrB,MAAM,cAAc,CAAC;AAGtB,qBAAa,iBAAkB,YAAW,SAAS;IACjD,WAAW,EAAE,oBAAoB,CA+L/B;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsC/D,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAmLxE"}

package/dist/nodes/NebulaHitlRequest/NebulaHitlRequest.node.js

@@ -0,0 +1,390 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NebulaHitlRequest = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const uuid_1 = require("uuid");
+class NebulaHitlRequest {
+    description = {
+        displayName: 'Nebula HITL Request',
+        name: 'nebulaHitlRequest',
+        // Note: Custom SVG icons don't work with N8N_CUSTOM_EXTENSIONS due to n8n bug
+        // See: https://github.com/n8n-io/n8n/issues/21360
+        // Using Font Awesome as fallback. Install via npm for custom SVG icons.
+        icon: 'fa:user-clock',
+        group: ['transform'],
+        version: 1,
+        subtitle: '={{$parameter["operation"]}}',
+        description: 'Send Human-in-the-Loop requests via Nebula and wait for responses',
+        defaults: {
+            name: 'Nebula HITL Request',
+        },
+        inputs: ['main'],
+        outputs: ['main'],
+        credentials: [
+            {
+                name: 'nebulaApi',
+                required: true,
+            },
+        ],
+        webhooks: [
+            {
+                name: 'default',
+                httpMethod: 'POST',
+                responseMode: 'onReceived',
+                path: 'nebula-hitl-response',
+                restartWebhook: true,
+            },
+        ],
+        properties: [
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                options: [
+                    {
+                        name: 'HITL Request',
+                        value: 'hitlRequest',
+                        description: 'Create a Human-in-the-Loop request and wait for response',
+                        action: 'Create a HITL request and wait for response',
+                    },
+                ],
+                default: 'hitlRequest',
+            },
+            {
+                displayName: 'Title',
+                name: 'title',
+                type: 'string',
+                default: '',
+                placeholder: 'Approval Required',
+                description: 'A short title for the HITL request',
+                required: true,
+                displayOptions: {
+                    show: {
+                        operation: ['hitlRequest'],
+                    },
+                },
+            },
+            {
+                displayName: 'Message',
+                name: 'message',
+                type: 'string',
+                typeOptions: {
+                    rows: 6,
+                },
+                default: '',
+                placeholder: 'Please review the following information and provide your approval...',
+                description: 'A detailed message in Markdown format',
+                required: true,
+                displayOptions: {
+                    show: {
+                        operation: ['hitlRequest'],
+                    },
+                },
+            },
+            {
+                displayName: 'Response Type',
+                name: 'responseType',
+                type: 'options',
+                options: [
+                    {
+                        name: 'Ok',
+                        value: 'ok',
+                        description: 'Simple acknowledgement with an OK button',
+                    },
+                    {
+                        name: 'Yes/No',
+                        value: 'yesno',
+                        description: 'Binary choice between Yes and No',
+                    },
+                    {
+                        name: 'Text',
+                        value: 'text',
+                        description: 'Free-form text input',
+                    },
+                    {
+                        name: 'Form (survey.json)',
+                        value: 'form',
+                        description: 'Custom form defined as survey.json JSON format',
+                    },
+                ],
+                default: 'ok',
+                description: 'The type of response expected from the human',
+                displayOptions: {
+                    show: {
+                        operation: ['hitlRequest'],
+                    },
+                },
+            },
+            {
+                displayName: 'Form JSON',
+                name: 'formJson',
+                type: 'json',
+                default: '{\n  "elements": [\n    {\n      "type": "radiogroup",\n      "name": "decision",\n      "title": "Please select an option",\n      "choices": ["Approve", "Reject", "Need More Info"]\n    }\n  ]\n}',
+                placeholder: '{"elements": [{"type": "text", "name": "comment", "title": "Your comment"}]}',
+                description: 'Form definition in survey.json JSON format',
+                displayOptions: {
+                    show: {
+                        operation: ['hitlRequest'],
+                        responseType: ['form'],
+                    },
+                },
+            },
+            {
+                displayName: 'Additional Data',
+                name: 'additionalData',
+                type: 'json',
+                default: '{}',
+                description: 'Additional JSON data to include with the request',
+                displayOptions: {
+                    show: {
+                        operation: ['hitlRequest'],
+                    },
+                },
+            },
+            {
+                displayName: 'Options',
+                name: 'options',
+                type: 'collection',
+                placeholder: 'Add Option',
+                default: {},
+                displayOptions: {
+                    show: {
+                        operation: ['hitlRequest'],
+                    },
+                },
+                options: [
+                    {
+                        displayName: 'Priority',
+                        name: 'priority',
+                        type: 'options',
+                        options: [
+                            { name: 'Low', value: 'low' },
+                            { name: 'Normal', value: 'normal' },
+                            { name: 'High', value: 'high' },
+                            { name: 'Urgent', value: 'urgent' },
+                        ],
+                        default: 'normal',
+                        description: 'Priority level of the request',
+                    },
+                    {
+                        displayName: 'Timeout (Minutes)',
+                        name: 'timeoutMinutes',
+                        type: 'number',
+                        default: 0,
+                        description: 'Timeout in minutes after which the workflow continues with a timeout response (0 = wait indefinitely)',
+                        typeOptions: {
+                            minValue: 0,
+                        },
+                    },
+                    {
+                        displayName: 'Assignee',
+                        name: 'assignee',
+                        type: 'string',
+                        default: '',
+                        description: 'Email or ID of the person to assign this request to',
+                    },
+                    {
+                        displayName: 'Tags',
+                        name: 'tags',
+                        type: 'string',
+                        default: '',
+                        description: 'Comma-separated list of tags',
+                    },
+                ],
+            },
+        ],
+    };
+    async webhook() {
+        const bodyData = this.getBodyData();
+        // Validate the incoming webhook has required data
+        if (!bodyData.requestId) {
+            return {
+                webhookResponse: {
+                    status: 400,
+                    body: { error: 'Missing requestId in webhook payload' },
+                },
+            };
+        }
+        // Return the response data to continue the workflow
+        // The webhook data becomes the output of the node
+        return {
+            webhookResponse: {
+                status: 200,
+                body: { success: true, message: 'Response received, workflow will continue' },
+            },
+            workflowData: [
+                [
+                    {
+                        json: {
+                            requestId: bodyData.requestId,
+                            response: bodyData.response,
+                            responseValue: bodyData.responseValue,
+                            respondedBy: bodyData.respondedBy,
+                            respondedAt: bodyData.respondedAt || new Date().toISOString(),
+                            comment: bodyData.comment,
+                            data: bodyData.data || {},
+                        },
+                    },
+                ],
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        // Check if we're resuming from a webhook (execution was waiting)
+        const waitingWebhookData = this.getInputData();
+        // If we have webhook response data (resuming), pass it through
+        // This happens when the webhook is called and the execution resumes
+        if (waitingWebhookData.length > 0 &&
+            waitingWebhookData[0].json.requestId &&
+            waitingWebhookData[0].json.response !== undefined) {
+            // We're resuming from webhook - return the webhook data as output
+            return [waitingWebhookData];
+        }
+        const operation = this.getNodeParameter('operation', 0);
+        if (operation === 'hitlRequest') {
+            // Process only the first item for the request
+            // (HITL requests typically handle one request at a time)
+            const itemIndex = 0;
+            try {
+                const credentials = await this.getCredentials('nebulaApi');
+                const baseUrl = credentials.baseUrl.replace(/\/$/, ''); // Remove trailing slash
+                // Parse metadata from credentials
+                let metadata = {};
+                try {
+                    metadata = credentials.metadata ? JSON.parse(credentials.metadata) : {};
+                }
+                catch {
+                    // Use empty object if parsing fails
+                }
+                // Get parameters
+                const title = this.getNodeParameter('title', itemIndex);
+                const message = this.getNodeParameter('message', itemIndex);
+                const responseType = this.getNodeParameter('responseType', itemIndex);
+                const additionalDataStr = this.getNodeParameter('additionalData', itemIndex, '{}');
+                const options = this.getNodeParameter('options', itemIndex, {});
+                // Get form JSON if response type is form
+                let form = {};
+                if (responseType === 'form') {
+                    const formJsonStr = this.getNodeParameter('formJson', itemIndex, '{}');
+                    try {
+                        form = JSON.parse(formJsonStr);
+                    }
+                    catch {
+                        // Use empty object if parsing fails
+                    }
+                }
+                // Generate unique request ID
+                const requestId = (0, uuid_1.v4)();
+                // Construct the webhook URL using n8n's built-in instance base URL
+                // The webhook path is defined in the node description as 'nebula-hitl-response'
+                const n8nBaseUrl = this.getInstanceBaseUrl().replace(/\/$/, '');
+                const executionId = this.getExecutionId();
+                // n8n webhook URL format for waiting executions: {baseUrl}/webhook-waiting/{executionId}/nebula-hitl-response
+                const webhookUrl = `${n8nBaseUrl}/webhook-waiting/${executionId}/nebula-hitl-response`;
+                // Parse additional data
+                let parsedAdditionalData = {};
+                try {
+                    parsedAdditionalData = JSON.parse(additionalDataStr);
+                }
+                catch {
+                    // If parsing fails, use empty object
+                }
+                // Store incoming item data for reference
+                const inputItemData = items[itemIndex]?.json || {};
+                // Get workflow info
+                const workflow = this.getWorkflow();
+                // Build request payload
+                const payload = {
+                    requestId,
+                    title,
+                    message,
+                    responseType,
+                    form: responseType === 'form' ? form : undefined,
+                    webhookUrl, // The URL the backend should POST to when responding
+                    priority: options.priority || 'normal',
+                    timeoutMinutes: options.timeoutMinutes || 0,
+                    assignee: options.assignee || undefined,
+                    tags: options.tags ? options.tags.split(',').map((t) => t.trim()) : [],
+                    metadata,
+                    additionalData: parsedAdditionalData,
+                    inputData: inputItemData,
+                    workflowId: workflow.id,
+                    workflowName: workflow.name,
+                    executionId,
+                    createdAt: new Date().toISOString(),
+                };
+                // Make HTTP POST request to create the HITL request
+                try {
+                    await this.helpers.httpRequest({
+                        method: 'POST',
+                        url: `${baseUrl}/requests`,
+                        body: payload,
+                        json: true,
+                        auth: {
+                            username: credentials.username,
+                            password: credentials.password,
+                        },
+                        headers: {
+                            'Content-Type': 'application/json',
+                        },
+                    });
+                }
+                catch (error) {
+                    throw new n8n_workflow_1.NodeApiError(this.getNode(), { error: error.message }, {
+                        message: 'Failed to create HITL request on the Nebula server',
+                    });
+                }
+                // Calculate the wait timeout
+                const timeoutMinutes = options.timeoutMinutes || 0;
+                let waitTill;
+                if (timeoutMinutes > 0) {
+                    // Wait until the specified timeout
+                    waitTill = new Date(Date.now() + timeoutMinutes * 60 * 1000);
+                }
+                else {
+                    // Wait indefinitely (max date - n8n will handle this)
+                    // Set to 1 year from now as "indefinite"
+                    waitTill = new Date(Date.now() + 365 * 24 * 60 * 60 * 1000);
+                }
+                // Store request info in static data for potential reference
+                const staticData = this.getWorkflowStaticData('node');
+                staticData.currentRequest = {
+                    requestId,
+                    title,
+                    webhookUrl,
+                    createdAt: payload.createdAt,
+                    waitTill: waitTill.toISOString(),
+                };
+                // PUT THE EXECUTION TO WAIT!
+                // This is the key - it pauses the workflow until the webhook is called
+                // or the timeout is reached
+                await this.putExecutionToWait(waitTill);
+                // This code is reached when the execution resumes (either from webhook or timeout)
+                // However, in practice, when webhook is called, n8n handles the resume differently
+                // Return empty - the webhook handler will provide the actual output
+                return [[]];
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    return [
+                        [
+                            {
+                                json: {
+                                    error: error.message,
+                                },
+                                pairedItem: { item: itemIndex },
+                            },
+                        ],
+                    ];
+                }
+                throw error;
+            }
+        }
+        // Default return for unknown operations
+        return [[]];
+    }
+}
+exports.NebulaHitlRequest = NebulaHitlRequest;
+//# sourceMappingURL=NebulaHitlRequest.node.js.map

package/dist/nodes/NebulaHitlRequest/NebulaHitlRequest.node.js.map

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

package/dist/nodes/NebulaHitlRequest/NebulaHitlRequest.node.json

@@ -0,0 +1,28 @@
+{
+  "node": "n8n-nodes-nebula.nebulaHitlRequest",
+  "nodeVersion": "1.0",
+  "codexVersion": "1.0",
+  "categories": ["Utility", "Core Nodes"],
+  "resources": {
+    "primaryDocumentation": [
+      {
+        "url": "https://github.com/linkorb/n8n-nodes-nebula"
+      }
+    ]
+  },
+  "alias": [
+    "nebula",
+    "hitl",
+    "human",
+    "approval",
+    "wait",
+    "human in the loop",
+    "manual",
+    "confirm",
+    "review"
+  ],
+  "subcategories": {
+    "Core Nodes": ["Flow"]
+  }
+}
+

package/dist/nodes/NebulaHitlRequest/nebulaHitlRequest.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60">
+  <rect width="60" height="60" rx="8" fill="#5C6BC0"/>
+  <circle cx="30" cy="18" r="7" fill="#fff"/>
+  <path d="M18 42c0-8.284 5.373-15 12-15s12 6.716 12 15v3H18v-3z" fill="#fff"/>
+  <circle cx="44" cy="18" r="8" fill="#FF7043"/>
+  <path d="M44 12v8M44 22v2" stroke="#fff" stroke-width="2.5" stroke-linecap="round"/>
+</svg>

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@linkorb/n8n-nodes-nebula",
+  "version": "1.0.0",
+  "description": "n8n nodes for Nebula - Human-in-the-Loop (HITL) requests with configurable REST API backend",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "nebula",
+    "human-in-the-loop",
+    "hitl",
+    "approval",
+    "nebula-hitl"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/linkorb/n8n-nodes-nebula",
+  "author": {
+    "name": "Joost Faassen"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/linkorb/n8n-nodes-nebula.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.10",
+    "pnpm": ">=9.1"
+  },
+  "packageManager": "pnpm@9.1.4",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc && gulp build:icons",
+    "dev": "tsc --watch",
+    "format": "prettier nodes credentials --write",
+    "lint": "eslint nodes credentials package.json",
+    "lintfix": "eslint nodes credentials package.json --fix",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/NebulaApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/NebulaHitlRequest/NebulaHitlRequest.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/parser": "^8.18.0",
+    "eslint": "^9.16.0",
+    "gulp": "^5.0.0",
+    "n8n-workflow": "^1.70.0",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2"
+  },
+  "dependencies": {
+    "uuid": "^11.0.3"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}