@nornweave/n8n-nodes-nornweave 0.1.0

package/README.md

@@ -0,0 +1,113 @@
+# @nornweave/n8n-nodes-nornweave
+
+This is an n8n community node for [NornWeave](https://nornweave.io) - an open-source, self-hosted Inbox-as-a-Service API for AI Agents.
+
+NornWeave provides a stateful email layer (Inboxes, Threads, History) and an intelligent layer (Markdown parsing, Semantic Search) for LLMs.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+### Quick Install
+
+1. Go to **Settings** > **Community Nodes**
+2. Select **Install**
+3. Enter `@nornweave/n8n-nodes-nornweave`
+4. Agree to the risks and select **Install**
+
+## Credentials
+
+To connect to your NornWeave instance, you need to create credentials:
+
+1. Go to **Credentials** > **Add credential**
+2. Search for "NornWeave API"
+3. Configure:
+   - **Base URL**: The URL of your NornWeave instance (e.g., `http://localhost:8000` or `https://nornweave.yourdomain.com`)
+   - **API Key** (optional): If your instance requires authentication, enter your API key
+
+The credential will be tested by calling the `/health` endpoint on your NornWeave instance.
+
+## Operations
+
+### NornWeave Node
+
+The main node supports the following operations:
+
+#### Inbox
+- **Create**: Create a new email inbox
+- **Delete**: Delete an inbox
+- **Get**: Get inbox details by ID
+- **Get Many**: List all inboxes
+
+#### Message
+- **Get**: Get a message by ID
+- **Get Many**: List messages in an inbox
+- **Send**: Send an outbound email (supports Markdown body, reply threading)
+
+#### Thread
+- **Get**: Get a thread with all messages (LLM-ready format)
+- **Get Many**: List threads in an inbox
+
+#### Search
+- **Query**: Search messages by content
+
+### NornWeave Trigger
+
+The trigger node listens for webhook events from NornWeave:
+
+- **Email Received**: New inbound email arrived
+- **Email Sent**: Outbound email accepted for delivery
+- **Email Delivered**: Email successfully delivered
+- **Email Bounced**: Email bounced (permanent failure)
+- **Email Opened**: Recipient opened the email
+- **Email Clicked**: Recipient clicked a link
+
+## Webhook Setup
+
+The NornWeave Trigger requires webhook configuration in your email provider:
+
+1. Add a **NornWeave Trigger** node to your workflow
+2. Copy the **Webhook URL** shown in the node (use the Production URL for live workflows)
+3. Configure your email provider (Mailgun, SendGrid, SES, Resend) to forward webhooks to this URL
+4. Activate your workflow
+
+See the [NornWeave n8n integration guide](https://nornweave.io/docs/integrations/n8n) for detailed setup instructions for each provider.
+
+## Example Workflows
+
+### Auto-reply to Support Emails
+
+```
+NornWeave Trigger (email.received) 
+  → IF (subject contains "support")
+  → OpenAI (generate reply)
+  → NornWeave (Send message, reply_to_thread_id)
+```
+
+### Notify on Email Bounce
+
+```
+NornWeave Trigger (email.bounced)
+  → Slack (post to #alerts channel)
+```
+
+### Weekly Inbox Summary
+
+```
+Schedule Trigger (weekly)
+  → NornWeave (Get Many threads)
+  → OpenAI (summarize)
+  → Email (send summary)
+```
+
+## Resources
+
+- [NornWeave Documentation](https://nornweave.io/docs)
+- [NornWeave GitHub](https://github.com/nornweave/nornweave)
+- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
+
+## License
+
+MIT

package/dist/credentials/NornWeaveApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class NornWeaveApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: "file:../icons/nornweave.svg";
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/NornWeaveApi.credentials.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NornWeaveApi = void 0;
+class NornWeaveApi {
+    constructor() {
+        this.name = 'nornWeaveApi';
+        this.displayName = 'NornWeave API';
+        this.icon = 'file:../icons/nornweave.svg';
+        this.documentationUrl = 'https://nornweave.io/docs/integrations/n8n';
+        this.properties = [
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'http://localhost:8000',
+                placeholder: 'https://your-nornweave-instance.com',
+                description: 'The base URL of your NornWeave instance',
+                required: true,
+            },
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: 'Optional API key for authentication. Leave empty if your instance does not require authentication.',
+                required: false,
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'X-API-Key': '={{$credentials?.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials?.baseUrl}}',
+                url: '/health',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.NornWeaveApi = NornWeaveApi;
+//# sourceMappingURL=NornWeaveApi.credentials.js.map

package/dist/credentials/NornWeaveApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NornWeaveApi.credentials.js","sourceRoot":"","sources":["../../credentials/NornWeaveApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,YAAY;IAAzB;QACE,SAAI,GAAG,cAAc,CAAC;QAEtB,gBAAW,GAAG,eAAe,CAAC;QAE9B,SAAI,GAAG,6BAAsC,CAAC;QAE9C,qBAAgB,GAAG,4CAA4C,CAAC;QAEhE,eAAU,GAAsB;YAC9B;gBACE,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,WAAW,EAAE,qCAAqC;gBAClD,WAAW,EAAE,yCAAyC;gBACtD,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,oGAAoG;gBACjH,QAAQ,EAAE,KAAK;aAChB;SACF,CAAC;QAEF,iBAAY,GAAyB;YACnC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,WAAW,EAAE,2BAA2B;iBACzC;aACF;SACF,CAAC;QAEF,SAAI,GAA2B;YAC7B,OAAO,EAAE;gBACP,OAAO,EAAE,4BAA4B;gBACrC,GAAG,EAAE,SAAS;gBACd,MAAM,EAAE,KAAK;aACd;SACF,CAAC;IACJ,CAAC;CAAA;AA9CD,oCA8CC"}

package/dist/icons/nornweave.svg

@@ -0,0 +1,20 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+  <defs>
+    <linearGradient id="gradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#6366f1;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#8b5cf6;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  <!-- Background circle -->
+  <circle cx="50" cy="50" r="45" fill="url(#gradient)"/>
+  <!-- Stylized "N" representing threads/weaving -->
+  <path d="M30 70 L30 30 L50 55 L50 30 L70 30 L70 70 L50 45 L50 70 Z" 
+        fill="white" 
+        stroke="white" 
+        stroke-width="2" 
+        stroke-linejoin="round"/>
+  <!-- Three dots representing the Norns -->
+  <circle cx="35" cy="22" r="4" fill="white" opacity="0.8"/>
+  <circle cx="50" cy="18" r="4" fill="white" opacity="0.8"/>
+  <circle cx="65" cy="22" r="4" fill="white" opacity="0.8"/>
+</svg>

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

@@ -0,0 +1,4 @@
+import { type INodeType, type INodeTypeDescription } from 'n8n-workflow';
+export declare class NornWeave implements INodeType {
+    description: INodeTypeDescription;
+}